Download OpenAPI specification:Download
SkyPortal provides an API to access most of its underlying
functionality. To use it, you will need an API token. This
can be generated via the web application from your profile page or, if
you are an admin, you may use the system provisioned token stored
inside of .tokens.yaml.
Once you have a token, you may access SkyPortal programmatically as follows.
import requests
token = 'ea70a5f0-b321-43c6-96a1-b2de225e0339'
def api(method, endpoint, data=None):
headers = {'Authorization': f'token {token}'}
response = requests.request(method, endpoint, json=data, headers=headers)
return response
response = api('GET', 'http://localhost:5000/api/sysinfo')
print(f'HTTP code: {response.status_code}, {response.reason}')
if response.status_code in (200, 400):
print(f'JSON response: {response.json()}')
curl -s -H 'Authorization: token ea70a5f0-b321-43c6-96a1-b2de225e0339' http://localhost:5000/api/sysinfo
There are two ways to pass information along with a request: path and body parameters.
Path parameters (also called query or URL parameters) are embedded in
the URL called. For example, you can specify numPerPage or
pageNumber path parameters when calling /api/candidates as
follows:
curl -s -H 'Authorization: token ea70a5f0-b321-43c6-96a1-b2de225e0339' \
http://localhost:5000/api/candidates?numPerPage=100&pageNumber=1
When using Python's requests library, a dictionary of path
parameters can be passed in via the params keyword argument:
token = 'ea70a5f0-b321-43c6-96a1-b2de225e0339'
response = requests.get(
"http://localhost:5000/api/sources",
params={"includeComments": True, "includeThumbnails": False},
headers={'Authorization': f'token {token}'},
)
Request body parameters (or simply: the body of the request)
contains data uploaded to a specific endpoint. These are the
parameters listed under REQUEST BODY SCHEMA: application/json in the
API docs.
When using Python's requests library, body parameters are specified
using the json keyword argument:
token = "abc"
response = requests.post(
"http://localhost:5000/api/sources",
json={
"id": "14gqr",
"ra": 353.36647,
"dec": 33.646149,
"group_ids": [52, 97],
},
headers={"Authorization": f"token {token}"},
)
In the above examples, the SkyPortal server is located at
http://localhost:5000. In case of success, the HTTP response is 200:
HTTP code: 200, OK
JSON response: {'status': 'success', 'data': {}, 'version': '0.9.dev0+git20200819.84c453a'}
On failure, it is 400; the JSON response has status="error" with the reason
for the failure given in message:
{
"status": "error",
"message": "Invalid API endpoint",
"data": {},
"version": "0.9.1"
}
Several API endpoints (notably the sources and candidates APIs) enforce pagination to limit the number of records that can be fetched per request. These APIs expose parameters that facilitate pagination (see the various API docs for details). A sample pagination script is included here:
import requests
import time
base_url = "https://fritz.science/api/sources"
token = "your_token_id_here"
group_ids = [4, 71] # If applicable
all_sources = []
num_per_page = 500
page = 1
total_matches = None
retry_attempts = 0
max_retry_attempts = 10
while retry_attempts <= max_retry_attempts:
r = requests.get(
f"{base_url}?group_ids={','.join([str(gid) for gid in group_ids])}&pageNumber={page}&numPerPage={num_per_page}&totalMatches={total_matches}",
headers={"Authorization": f"token {token}"},
)
if r.status_code == 429:
print("Request rate limit exceeded; sleeping 1s before trying again...")
time.sleep(1)
continue
data = r.json()
if data["status"] != "success":
print(data) # log as appropriate
retry_attempts += 1
time.sleep(5)
continue
else:
retry_attempts = 0
all_sources.extend(data["data"]["sources"])
total_matches = data["data"]["totalMatches"]
print(f"Fetched {len(all_sources)} of {total_matches} sources.")
if len(all_sources) >= total_matches:
break
page += 1
Produce a report on allocations for an instrument
| instrument_id required | integer |
| output_format | string Output format for analysis. Can be png or pdf |
{- "status": "success",
- "message": "string"
}Retrieve observation plans associated with an allocation
| allocation_id required | integer |
| numPerPage | integer Number of observation plans to return per paginated request. Defaults to 10. Can be no larger than {MAX_OBSERVATION_PLANS}. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
]
}Retrieve an allocation
| allocation_id required | integer |
| numPerPage | integer Number of followup requests to return per paginated request. Defaults to 10. Can be no larger than {MAX_FOLLOWUP_REQUESTS}. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- null
], - "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string",
- "id": 0
}
}Update an allocation on a robotic instrument
| allocation_id required | integer |
| requests | Array of any |
| default_requests | Array of any |
| default_observation_plans | Array of any |
| catalog_queries | Array of any |
| observation_plans | Array of any |
| group | any or null The Group the allocation is associated with. |
| instrument | any or null The Instrument the allocation is associated with. |
| allocation_users | Array of any |
| gcn_triggers | Array of any |
| pi | string or null The PI of the allocation's proposal. |
| proposal_id | string or null The ID of the proposal associated with this allocation. |
| start_date | string or null <date-time> The UTC start date of the allocation. |
| end_date | string or null <date-time> The UTC end date of the allocation. |
| hours_allocated required | number The number of hours allocated. |
| default_share_group_ids | any or null |
| types | Array of any The type of allocation. |
| group_id required | integer The ID of the Group the allocation is associated with. |
| instrument_id required | integer The ID of the Instrument the allocation is associated with. |
| _altdata | string or null |
{- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- null
], - "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string"
}{- "status": "success",
- "message": "string"
}Retrieve all allocations
| instrument_id | number Instrument ID to retrieve allocations for |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- null
], - "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string",
- "id": 0
}
]
}Post new allocation on a robotic instrument
| requests | Array of any |
| default_requests | Array of any |
| default_observation_plans | Array of any |
| catalog_queries | Array of any |
| observation_plans | Array of any |
| group | any or null The Group the allocation is associated with. |
| instrument | any or null The Instrument the allocation is associated with. |
| allocation_users | Array of any |
| gcn_triggers | Array of any |
| pi | string or null The PI of the allocation's proposal. |
| proposal_id | string or null The ID of the proposal associated with this allocation. |
| start_date | string or null <date-time> The UTC start date of the allocation. |
| end_date | string or null <date-time> The UTC end date of the allocation. |
| hours_allocated required | number The number of hours allocated. |
| default_share_group_ids | any or null |
| types | Array of any The type of allocation. |
| group_id required | integer The ID of the Group the allocation is associated with. |
| instrument_id required | integer The ID of the Instrument the allocation is associated with. |
| _altdata | string or null |
{- "requests": [
- null
], - "default_requests": [
- null
], - "default_observation_plans": [
- null
], - "catalog_queries": [
- null
], - "observation_plans": [
- null
], - "group": null,
- "instrument": null,
- "allocation_users": [
- null
], - "gcn_triggers": [
- null
], - "pi": "string",
- "proposal_id": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "hours_allocated": 0,
- "default_share_group_ids": null,
- "types": [
- null
], - "group_id": 0,
- "instrument_id": 0,
- "_altdata": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve all observation analyses
| gcnevent_id | number GcnEvent ID to retrieve observation efficiency analyses for |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "gcnevent": null,
- "localization": null,
- "instrument": null,
- "requester": null,
- "groups": [
- null
], - "gcnevent_id": 0,
- "localization_id": 0,
- "instrument_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
]
}Retrieve all observation plan efficiency analyses
| observation_plan_id | number EventObservationPlan ID to retrieve observation plan efficiency analyses for |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
]
}Retrieve observation plans associated with an allocation
| allocation_id required | integer |
| numPerPage | integer Number of observation plans to return per paginated request. Defaults to 10. Can be no larger than {MAX_OBSERVATION_PLANS}. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
]
}Retrieve a default analysis
| analysis_service_id required | any Analysis service ID |
| default_analysis_id required | any Default analysis ID |
{- "status": "success",
- "message": "string",
- "data": {
- "analysis_service": null,
- "groups": [
- null
], - "author": null,
- "analysis_service_id": 0,
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "default_analysis_parameters": "string",
- "source_filter": null,
- "stats": null,
- "author_id": 0,
- "id": 0
}
}Retrieve all default analyses
| analysis_service_id required | any Analysis service ID, if not provided, return all default analyses for all analysis services |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "analysis_service": null,
- "groups": [
- null
], - "author": null,
- "analysis_service_id": 0,
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "default_analysis_parameters": "string",
- "source_filter": null,
- "stats": null,
- "author_id": 0,
- "id": 0
}
]
}Get Swift LSXPS objects and post them as sources. Repeated posting will skip the existing source.
| telescope_name | integer Name of telescope to assign this catalog to. Use the same name as your nickname for the Neil Gehrels Swift Observatory. Defaults to Swift. |
| groupIDs | object If provided, save to these group IDs. |
{- "telescope_name": 0,
- "groupIDs": { }
}{- "status": "success",
- "message": "string"
}Get Gaia Photometric Alert objects and post them as sources. Repeated posting will skip the existing source.
| telescope_name | string Name of telescope to assign this catalog to. Use the same name as your nickname for Gaia. Defaults to Gaia. |
| groupIDs | object If provided, save to these group IDs. |
| startDate | str Arrow parsable string. Filter by start date. |
| endDate | str Arrow parsable string. Filter by end date. |
{- "telescope_name": "string",
- "groupIDs": { },
- "startDate": null,
- "endDate": null
}{- "status": "success",
- "message": "string"
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "sent_by": null,
- "notices": [
- null
], - "predictions": [
- null
], - "measurements": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "sent_by_id": 0,
- "event_id": "string",
- "event_uri": "string",
- "status": "string",
- "id": 0
}
]
}get Gaia parallax and magnitudes and post them as an annotation, based on cross-match to the Gaia DR3.
| obj_id required | string ID of the object to retrieve Gaia colors for |
| catalog | string The name of the catalog key, associated with a catalog cross match, from which the data should be retrieved. Default is "gaiadr3.gaia_source". |
| crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve Gaia sources If not specified (or None) will use the default from the config file, or 2 arcsec if not specified in the config. |
| crossmatchLimmag | number Crossmatch limiting magnitude (for Gaia G mag). Will ignore sources fainter than this magnitude. If not specified, will use the default value in the config file, or None if not specified in the config. If value is cast to False (0, False or None), will take sources of any magnitude. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "catalog": "string",
- "crossmatchRadius": 0,
- "crossmatchLimmag": 0,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}get WISE colors and post them as an annotation based on cross-matches to some catalog (default is allwise_p3as_psd).
| obj_id required | string ID of the object to retrieve WISE colors for |
| catalog | string The name of the catalog key, associated with a catalog cross match, from which the data should be retrieved. Default is allwise_p3as_psd. |
| crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve photoz's Default is 2. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "catalog": "string",
- "crossmatchRadius": 0,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}get cross-match with Vizier and post them as an annotation based on cross-matches to some catalog (default is VII/290, i.e. the million quasar catalog).
| obj_id required | string ID of the object to retrieve the Vizier crossmatch for |
| catalog | string The name of the catalog key, associated with a catalog cross match, from which the data should be retrieved. Default is VII/290. |
| crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve photoz's Default is 2. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "catalog": "string",
- "crossmatchRadius": 0,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}get PS1 sources and post them as an annotation
| obj_id required | string ID of the object to retrieve PS1 sources for |
| catalog | string The name of the catalog key, used when posting annotations. Default is ps1.dr2. This is not used for the query, which will always query DR2. |
| crossmatchRadius | number Crossmatch radius (in arcseconds) to retrieve PS1 sources Default is 2. |
| crossmatchMinDetections | number Crossmatch minimum number of detections to retrieve PS1 sources Default is 1. |
| crossmatchNumber | number Crossmatch number of sources (maximum) to retrieve from PS1 Default is 1, max is 5. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "catalog": "string",
- "crossmatchRadius": 0,
- "crossmatchMinDetections": 0,
- "crossmatchNumber": 0,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Add autoreporter(s) to a TNSRobotGroup
| tnsrobot_id required | string The ID of the TNSRobot |
| group_id required | string The ID of the group to add autoreporter(s) to |
| user_id | string The ID of the user to add as an autoreporter |
| user_ids | Array of strings An array of user IDs to add as autoreporters. If a string is provided, it will be split by commas. |
{- "user_ids": [
- "string"
]
}{- "status": "success",
- "message": "string"
}Retrieve a TNSRobotSubmission
| tnsrobot_id required | integer The ID of the TNSRobot |
| id required | integer The ID of the TNSRobotSubmission |
{- "tnsrobot": null,
- "obj": null,
- "user": null,
- "tnsrobot_id": 0,
- "obj_id": "string",
- "user_id": 0,
- "custom_reporting_string": "string",
- "custom_remarks_string": "string",
- "status": "string",
- "archival": true,
- "archival_comment": "string",
- "submission_id": 0,
- "auto_submission": true,
- "instrument_ids": null,
- "stream_ids": null,
- "photometry_options": null,
- "payload": null,
- "response": null,
- "id": 0
}Retrieve all TNSRobotSubmissions
| tnsrobot_id required | integer The ID of the TNSRobot |
| pageNumber | integer The page number to retrieve, starting at 1 |
| numPerPage | integer The number of results per page, defaults to 100 |
| include_payload | boolean Whether to include the payload in the response |
| include_response | boolean Whether to include the response in the response |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "tnsrobot": null,
- "obj": null,
- "user": null,
- "tnsrobot_id": 0,
- "obj_id": "string",
- "user_id": 0,
- "custom_reporting_string": "string",
- "custom_remarks_string": "string",
- "status": "string",
- "archival": true,
- "archival_comment": "string",
- "submission_id": 0,
- "auto_submission": true,
- "instrument_ids": null,
- "stream_ids": null,
- "photometry_options": null,
- "payload": null,
- "response": null,
- "id": 0
}
]
}Generate a PDF/PNG finding chart for a position or Gaia ID
| location_type required | string Enum: "gaia_dr3" "gaia_dr2" "pos" What is the type of the search? From gaia or by position? If |
| catalog_id | string |
| ra | float [ 0 .. 360 ) RA of the source of interest at the time of observation of interest (ie. the user is responsible for proper motion calulations). |
| dec | float [ -90 .. 90 ] DEC of the source of interest at the time of observation of interest (ie. the user is responsible for proper motion calulations). |
| imsize | float [ 2 .. 15 ] Image size in arcmin (square). Defaults to 4.0 |
| facility | string Enum: "Keck" "Shane" "P200" What type of starlist should be used? Defaults to Keck |
| image_source | string Enum: "ps1" "desi" "dss" "ztfref" Source of the image used in the finding chart. Defaults to ps1 |
| use_ztfref | boolean Use ZTFref catalog for offset star positions, otherwise DR3. Defaults to True. |
| obstime | string datetime of observation in isoformat (e.g. 2020-12-30T12:34:10). Defaults to now. |
| type | string Enum: "png" "pdf" Output datafile type. Defaults to pdf. |
| num_offset_stars | integer [ 0 .. 4 ] Number of offset stars to determine and show [0,4] (default: 3) |
{- "status": "error",
- "message": "string",
- "data": { }
}Retrieve an Analysis Service by id
| analysis_service_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "groups": [
- null
], - "obj_analyses": [
- null
], - "default_analyses": [
- null
], - "name": "string",
- "display_name": "string",
- "description": "string",
- "version": "string",
- "contact_name": "string",
- "contact_email": "string",
- "url": "string",
- "optional_analysis_parameters": "string",
- "authentication_type": "none",
- "_authinfo": "string",
- "enabled": true,
- "analysis_type": "lightcurve_fitting",
- "input_data_types": [
- null
], - "timeout": 0,
- "upload_only": true,
- "display_on_resource_dropdown": true,
- "is_summary": true,
- "id": 0
}
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "groups": [
- null
], - "obj_analyses": [
- null
], - "default_analyses": [
- null
], - "name": "string",
- "display_name": "string",
- "description": "string",
- "version": "string",
- "contact_name": "string",
- "contact_email": "string",
- "url": "string",
- "optional_analysis_parameters": "string",
- "authentication_type": "none",
- "_authinfo": "string",
- "enabled": true,
- "analysis_type": "lightcurve_fitting",
- "input_data_types": [
- null
], - "timeout": 0,
- "upload_only": true,
- "display_on_resource_dropdown": true,
- "is_summary": true,
- "id": 0
}
]
}Upload an upload_only analysis result
| analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
| resource_id required | string The ID of the underlying data. This would be a string for an object ID. |
| analysis_service_id required | string the analysis service id to be used |
| results | object Results data of this analysis |
| show_parameters | boolean Whether to render the parameters of this analysis |
| show_plots | boolean Whether to render the plots of this analysis |
| show_corner | boolean Whether to render the corner plots of this analysis |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view analysis results. Defaults to all of requesting user's groups. |
{- "results": { },
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "analysis_id": 0
}
}Retrieve an Analysis by id
| analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
| analysis_id required | int ID of the analysis to return. |
| objID | string Return any analysis on an object with ID objID |
| analysisServiceID | int ID of the analysis service used to create the analysis, used only if no analysis_id is given |
| includeAnalysisData | boolean Boolean indicating whether to include the data associated with the analysis in the response. Could be a large amount of data. Only works for single analysis requests. Defaults to false. |
| summaryOnly | boolean Boolean indicating whether to return only analyses that
use analysis services with |
| includeFilename | boolean Boolean indicating whether to include the filename of the data associated with the analysis in the response. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_message": "string"
}
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_message": "string"
}
]
}Begin an analysis run
| analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
| resource_id required | string The ID of the underlying data. This would be a string for an object ID. |
| analysis_service_id required | string the analysis service id to be used |
| show_parameters | boolean Whether to render the parameters of this analysis |
| show_plots | boolean Whether to render the plots of this analysis |
| show_corner | boolean Whether to render the corner plots of this analysis |
| input_filters | Array of arrays Filters to apply to the input data |
object Dictionary of parameters to be passed thru to the analysis | |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view analysis results. Defaults to all of requesting user's groups. |
{- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "input_filters": [ ],
- "analysis_parameters": {
- "property1": "string",
- "property2": "string"
}, - "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "analysis_id": 0
}
}Retrieve an Analysis by id
| analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
| analysis_id required | int ID of the analysis to return. |
| objID | string Return any analysis on an object with ID objID |
| analysisServiceID | int ID of the analysis service used to create the analysis, used only if no analysis_id is given |
| includeAnalysisData | boolean Boolean indicating whether to include the data associated with the analysis in the response. Could be a large amount of data. Only works for single analysis requests. Defaults to false. |
| summaryOnly | boolean Boolean indicating whether to return only analyses that
use analysis services with |
| includeFilename | boolean Boolean indicating whether to include the filename of the data associated with the analysis in the response. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_message": "string"
}
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "analysis_service": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "_unique_id": "string",
- "hash": "string",
- "_full_name": "string",
- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "analysis_parameters": "string",
- "input_filters": "string",
- "author_id": 0,
- "analysis_service_id": 0,
- "invalid_after": "2019-08-24T14:15:22Z",
- "token": "string",
- "handled_by_url": "string",
- "status": "queued",
- "duration": 0,
- "last_activity": "2019-08-24T14:15:22Z",
- "status_message": "string"
}
]
}Begin an analysis run
| analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
| resource_id required | string The ID of the underlying data. This would be a string for an object ID. |
| analysis_service_id required | string the analysis service id to be used |
| show_parameters | boolean Whether to render the parameters of this analysis |
| show_plots | boolean Whether to render the plots of this analysis |
| show_corner | boolean Whether to render the corner plots of this analysis |
| input_filters | Array of arrays Filters to apply to the input data |
object Dictionary of parameters to be passed thru to the analysis | |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view analysis results. Defaults to all of requesting user's groups. |
{- "show_parameters": true,
- "show_plots": true,
- "show_corner": true,
- "input_filters": [ ],
- "analysis_parameters": {
- "property1": "string",
- "property2": "string"
}, - "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "analysis_id": 0
}
}Retrieve primary data associated with an Analysis.
| analysis_resource_type required | string What underlying data the analysis is on: must be "obj" (more to be added in the future) |
| analysis_id required | integer |
| product_type required | string What type of data to retrieve: must be one of "corner", "results", or "plot" |
| plot_number required | integer if product_type == "plot", which plot number should be returned? Default to zero (first plot). |
| download | bool Download the results as a file |
object Extra parameters to pass to the plotting functions if new plots are to be generated (e.g. with corner plots) |
{- "download": null,
- "plot_kwargs": {
- "property1": { },
- "property2": { }
}
}{ }Retrieve an observing run assignment
| assignment_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "obj": null,
- "spectra": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "run": null,
- "requester_id": 0,
- "last_modified_by_id": 0,
- "obj_id": "string",
- "comment": "string",
- "status": "string",
- "priority": "1",
- "run_id": 0,
- "id": 0
}
}Update an assignment
| assignment_id required | integer |
| requester | any or null The User who created this assignment. |
| last_modified_by | any or null |
| obj | any or null The assigned Obj. |
| spectra | Array of any |
| photometry | Array of any |
| photometric_series | Array of any |
| run | any or null The ObservingRun this target was assigned to. |
| requester_id required | integer The ID of the User who created this assignment. |
| obj_id required | string ID of the assigned Obj. |
| comment | string or null A comment on the assignment. Typically a justification for the request, or instructions for taking the data. |
| status | string Status of the assignment [done, not done, pending]. |
| priority required | string <= 1 characters Enum: "1" "2" "3" "4" "5" Priority of the request (1 = lowest, 5 = highest). |
| run_id required | integer ID of the ObservingRun this target was assigned to. |
{- "requester": null,
- "last_modified_by": null,
- "obj": null,
- "spectra": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "run": null,
- "requester_id": 0,
- "obj_id": "string",
- "comment": "string",
- "status": "string",
- "priority": "1",
- "run_id": 0
}{- "status": "success",
- "message": "string"
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "last_modified_by": null,
- "obj": null,
- "spectra": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "run": null,
- "requester_id": 0,
- "last_modified_by_id": 0,
- "obj_id": "string",
- "comment": "string",
- "status": "string",
- "priority": "1",
- "run_id": 0,
- "id": 0
}
]
}Post new target assignment to observing run
| priority required | any Enum: "1" "2" "3" "4" "5" Priority of the request, (lowest = 1, highest = 5). |
| status | string The status of the request |
| run_id required | integer |
| obj_id required | string The ID of the object to observe. |
| comment | string An optional comment describing the request. |
{- "priority": "1",
- "status": "string",
- "run_id": 0,
- "obj_id": "string",
- "comment": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve a candidate
| obj_id required | string |
| includeComments | boolean Boolean indicating whether to include associated comments. Defaults to false. |
| includeAlerts | boolean Boolean indicating whether to include associated alerts. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}
}Retrieve all candidates
| numPerPage | integer Number of candidates to return per paginated request. Defaults to 25. Capped at 500. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
| totalMatches | integer Used only in the case of paginating query results - if provided, this allows for avoiding a potentially expensive query.count() call. |
| autosave | boolean Automatically save candidates passing query. |
| autosaveGroupIds | boolean Group ID(s) to save candidates to. |
| savedStatus | string Enum: "all" "savedToAllSelected" "savedToAnySelected" "savedToAnyAccessible" "notSavedToAnyAccessible" "notSavedToAnySelected" "notSavedToAllSelected" String indicating the saved status to filter candidate results for. Must be one of the enumerated values. |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by Candidate.passed_at >= startDate |
| endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by Candidate.passed_at <= endDate |
| groupIDs | Array of integers Comma-separated string of group IDs (e.g. "1,2"). Defaults to all of user's groups if filterIDs is not provided. |
| filterIDs | Array of integers Comma-separated string of filter IDs (e.g. "1,2"). Defaults to all of user's groups' filters if groupIDs is not provided. |
| annotationExcludeOrigin | string Only load objects that do not have annotations from this origin. If the annotationsExcludeOutdatedDate is also given, then annotations with this origin will still be loaded if they were modified before that date. |
| annotationExcludeOutdatedDate | string An Arrow parseable string designating when an existing annotation is outdated. Only relevant if giving the annotationExcludeOrigin argument. Will treat objects with outdated annotations as if they did not have that annotation, so it will load an object if it doesn't have an annotation with the origin specified or if it does have it but the annotation modified date < annotationsExcludeOutdatedDate |
| sortByAnnotationOrigin | string The origin of the Annotation to sort by |
| sortByAnnotationKey | string The key of the Annotation data value to sort by |
| sortByAnnotationOrder | string The sort order for annotations - either "asc" or "desc". Defaults to "asc". |
| annotationFilterList | Array of strings Comma-separated string of JSON objects representing annotation filters. Filter objects are expected to have keys { origin, key, value } for non-numeric value types, or { origin, key, min, max } for numeric values. |
| includePhotometry | boolean Boolean indicating whether to include associated photometry. Defaults to false. |
| includeSpectra | boolean Boolean indicating whether to include associated spectra. Defaults to false. |
| includeComments | boolean Boolean indicating whether to include associated comments. Defaults to false. |
| classifications | Array of strings Comma-separated string of classification(s) to filter for candidates matching that/those classification(s). |
| minRedshift | number If provided, return only candidates with a redshift of at least this value |
| maxRedshift | number If provided, return only candidates with a redshift of at most this value |
| listName | string Get only candidates saved to the querying user's list, e.g., "favorites". |
| listNameReject | string Get only candidates that ARE NOT saved to the querying user's list, e.g., "rejected_candidates". |
| photometryAnnotationsFilter | Array of strings Comma-separated string of "annotation: value: operator" triplet(s) to filter for sources matching that/those photometry annotation(s), i.e. "drb: 0.5: lt" |
| photometryAnnotationsFilterOrigin | string Comma separated string of origins. Only photometry annotations from these origins are used when filtering with the photometryAnnotationsFilter. |
| photometryAnnotationsFilterBefore | string Only return sources that have photometry annotations before this UTC datetime. |
| photometryAnnotationsFilterAfter | string Only return sources that have photometry annotations after this UTC datetime. |
| photometryAnnotationsFilterMinCount | string Only return sources that have at least this number of photometry annotations passing the photometry annotations filtering criteria. Defaults to 1. |
| localizationDateobs | string Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include sources |
| firstDetectionAfter | string Only return sources that were first detected after this UTC datetime. |
| lastDetectionBefore | string Only return sources that were last detected before this UTC datetime. |
| numberDetections | integer Only return sources that have been detected at least this many times. |
| requireDetections | boolean Require firstDetectionAfter, lastDetectionBefore, and numberDetections to be set when querying candidates in a localization. Defaults to True. |
| ignoreForcedPhotometry | boolean If true, ignore forced photometry when applying firstDetectionAfter, lastDetectionBefore, and numberDetections. Defaults to False. |
{- "status": "success",
- "message": "string",
- "data": {
- "candidates": [
- {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "is_source": true
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}Create new candidate(s) (one per filter).
| host | any or null The Galaxy associated with this source. |
| comments | Array of any |
| reminders | Array of any |
| comments_on_spectra | Array of any |
| reminders_on_spectra | Array of any |
| annotations | Array of any |
| annotations_on_spectra | Array of any |
| annotations_on_photometry | Array of any |
| classifications | Array of any |
| photometry | Array of any |
| photstats | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| thumbnails | Array of any |
| followup_requests | Array of any |
| assignments | Array of any |
| obj_notifications | Array of any |
| obj_analyses | Array of any |
| sources_in_gcns | Array of any |
| tns_submissions | Array of any |
| id required | string Name of the object. |
| ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
| dec_dis | number or null J2000 Declination at discovery time [deg]. |
| ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
| dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
| offset | number or null Offset from nearest static object [arcsec]. |
| redshift | number or null Redshift. |
| redshift_error | number or null Redshift error. |
| redshift_origin | string or null Redshift source. |
| host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
| summary | string or null Summary of the obj. |
| summary_history | any or null Record of the summaries generated and written about this obj |
| altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
| dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
| mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
| e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
| transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
| varstar | boolean or null Boolean indicating whether the object is a variable star. |
| is_roid | boolean or null Boolean indicating whether the object is a moving object. |
| mpc_name | string or null Minor planet center name. |
| gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
| tns_name | string or null Transient Name Server name. |
| tns_info | any or null TNS info in JSON format |
| score | number or null Machine learning score. |
| origin | string or null Origin of the object. |
| alias | any or null Alternative names for this object. |
| healpix | integer or null |
| detect_photometry_count | integer or null How many times the object was detected above :math: |
| ra | number or null |
| dec | number or null |
| candidates | Array of any |
| sources | Array of any |
| users | Array of any |
| filter_ids required | Array of integers List of associated filter IDs |
| passing_alert_id | integer or null ID of associated filter that created candidate |
| passed_at required | string or null Arrow-parseable datetime string indicating when passed filter. |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "healpix": 0,
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "filter_ids": [
- 0
], - "passing_alert_id": 0,
- "passed_at": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "ids": [
- 0
]
}
}Create new candidate(s) (one per filter).
| host | any or null The Galaxy associated with this source. |
| comments | Array of any |
| reminders | Array of any |
| comments_on_spectra | Array of any |
| reminders_on_spectra | Array of any |
| annotations | Array of any |
| annotations_on_spectra | Array of any |
| annotations_on_photometry | Array of any |
| classifications | Array of any |
| photometry | Array of any |
| photstats | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| thumbnails | Array of any |
| followup_requests | Array of any |
| assignments | Array of any |
| obj_notifications | Array of any |
| obj_analyses | Array of any |
| sources_in_gcns | Array of any |
| tns_submissions | Array of any |
| id required | string Name of the object. |
| ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
| dec_dis | number or null J2000 Declination at discovery time [deg]. |
| ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
| dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
| offset | number or null Offset from nearest static object [arcsec]. |
| redshift | number or null Redshift. |
| redshift_error | number or null Redshift error. |
| redshift_origin | string or null Redshift source. |
| host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
| summary | string or null Summary of the obj. |
| summary_history | any or null Record of the summaries generated and written about this obj |
| altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
| dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
| mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
| e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
| transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
| varstar | boolean or null Boolean indicating whether the object is a variable star. |
| is_roid | boolean or null Boolean indicating whether the object is a moving object. |
| mpc_name | string or null Minor planet center name. |
| gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
| tns_name | string or null Transient Name Server name. |
| tns_info | any or null TNS info in JSON format |
| score | number or null Machine learning score. |
| origin | string or null Origin of the object. |
| alias | any or null Alternative names for this object. |
| healpix | integer or null |
| detect_photometry_count | integer or null How many times the object was detected above :math: |
| ra | number or null |
| dec | number or null |
| candidates | Array of any |
| sources | Array of any |
| users | Array of any |
| filter_ids required | Array of integers List of associated filter IDs |
| passing_alert_id | integer or null ID of associated filter that created candidate |
| passed_at required | string or null Arrow-parseable datetime string indicating when passed filter. |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "healpix": 0,
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "filter_ids": [
- 0
], - "passing_alert_id": 0,
- "passed_at": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "ids": [
- 0
]
}
}Submit catalog queries
| status | string Default: "pending submission" The status of the request. |
| allocation_id required | integer Catalog query request allocation ID. |
| target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
| payload | any Content of the catalog query request. |
{- "status": "pending submission",
- "allocation_id": 0,
- "target_group_ids": [
- 0
], - "payload": null
}{- "status": "success",
- "message": "string"
}Vote for a classification.
| classification_id required | string ID of classification to indicate the vote for |
| vote required | integer Upvote or downvote a classification |
{- "vote": 0
}{- "status": "success",
- "message": "string"
}Retrieve a classification
| classification_id required | integer |
| includeTaxonomy | boolean Return associated taxonomy. |
{- "status": "success",
- "message": "string",
- "data": {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
}Update a classification
| classification required | integer |
| taxonomy | any or null Taxonomy in which this Classification was made. |
| author | any or null The User that made this classification. |
| obj | any or null The Classification's Obj. |
| groups | Array of any |
| votes | Array of any |
| classification required | string The assigned class. |
| origin | string or null String describing the source of this classification. |
| taxonomy_id required | integer ID of the Taxonomy in which this Classification was made. |
| probability | number or null User-assigned probability of belonging to this class |
| ml | boolean Whether this classification was made by a machine learning algorithm, or a human |
| author_id required | integer ID of the User that made this Classification |
| author_name required | string User.username or Token.id of the Classification's author. |
| obj_id required | string ID of the Classification's Obj. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view classification. |
{- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Delete a classification
| classification_id required | integer |
| label | boolean or null Add label associated with classification. |
{- "label": true
}{- "status": "success",
- "message": "string"
}Retrieve all classifications
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at >= startDate |
| endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at <= endDate |
| includeTaxonomy | boolean Return associated taxonomy. |
| numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "sources": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
], - "totalMatches": 0
}
}Post a classification
| obj_id required | string |
| classification required | string |
| origin | string String describing the source of this classification. |
| taxonomy_id required | integer |
| probability | float or null [ 0 .. 1 ] User-assigned probability of this classification on this taxonomy. If multiple classifications are given for the same source by the same user, the sum of the classifications ought to equal unity. Only individual probabilities are checked. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view classification. Defaults to all of requesting user's groups. |
| vote | boolean or null Add vote associated with classification. |
| label | boolean or null Add label associated with classification. |
{- "obj_id": "string",
- "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": null,
- "group_ids": [
- 0
], - "vote": true,
- "label": true
}{- "status": "success",
- "message": "string",
- "data": {
- "classification_id": 0
}
}Retrieve an object's classifications
| obj_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
]
}Delete all of an object's classifications
| classification_id required | integer |
| label | boolean or null Add label associated with classification. |
{- "label": true
}{- "status": "success",
- "message": "string"
}Vote for a classification.
| classification_id required | string ID of classification to indicate the vote for |
| vote required | integer Upvote or downvote a classification |
{- "vote": 0
}{- "status": "success",
- "message": "string"
}find the sources with classifications
| startDate | string Arrow-parseable date string (e.g. 2020-01-01) for when the classification was made. If provided, filter by created_at >= startDate |
| endDate | string Arrow-parseable date string (e.g. 2020-01-01) for when the classification was made. If provided, filter by created_at <= endDate |
{- "status": "success",
- "message": "string",
- "data": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "ALLOWED_SPECTRUM_TYPES": [ ],
- "ALLOWED_MAGSYSTEMS": [ ],
- "ALLOWED_BANDPASSES": [ ],
- "THUMBNAIL_TYPES": [ ],
- "FOLLOWUP_PRIORITIES": [ ],
- "ALLOWED_API_CLASSNAMES": [ ],
- "ANALYSIS_TYPES": [ ],
- "ANALYSIS_INPUT_TYPES": [ ],
- "AUTHENTICATION_TYPES": [ ]
}
}{- "status": "success",
- "message": "string",
- "data": {
- "Number of candidates": 0,
- "Number of objs": 0,
- "Number of sources": 0,
- "Number of photometry": 0,
- "Number of spectra": 0,
- "Number of groups": 0,
- "Number of users": 0,
- "Number of tokens": 0,
- "Oldest candidate creation datetime": "string",
- "Newest candidate creation datetime": "string"
}
}Retrieve a single default follow-up request
| default_followup_request_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "requester_id": 0,
- "payload": null,
- "allocation_id": 0,
- "default_followup_name": "string",
- "source_filter": null,
- "id": 0
}
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "requester_id": 0,
- "payload": null,
- "allocation_id": 0,
- "default_followup_name": "string",
- "source_filter": null,
- "id": 0
}
]
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "default_survey_efficiencies": [
- null
], - "requester_id": 0,
- "payload": null,
- "filters": null,
- "allocation_id": 0,
- "default_plan_name": "string",
- "id": 0
}
]
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "default_observationplan_request": null,
- "default_observationplan_request_id": 0,
- "payload": null,
- "id": 0
}
]
}Update filter name
| filter_id required | integer |
| stream | any or null The Filter's Stream. |
| group | any or null The Filter's Group. |
| candidates | Array of any |
| name required | string Filter name. |
| stream_id required | integer ID of the Filter's Stream. |
| group_id required | integer ID of the Filter's Group. |
{- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0
}{- "status": "success",
- "message": "string"
}POST a new filter.
| stream | any or null The Filter's Stream. |
| group | any or null The Filter's Group. |
| candidates | Array of any |
| name required | string Filter name. |
| stream_id required | integer ID of the Filter's Stream. |
| group_id required | integer ID of the Filter's Group. |
{- "stream": null,
- "group": null,
- "candidates": [
- null
], - "name": "string",
- "stream_id": 0,
- "group_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Create default follow-up request.
| allocation_id required | integer Follow-up request allocation ID. |
| target_group_ids | Array of integers IDs of groups to share the results of the default follow-up request with. |
| payload | any Content of the default follow-up request. |
{- "allocation_id": 0,
- "target_group_ids": [
- 0
], - "payload": null
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve a single default observation plan
| default_observation_plan_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "default_survey_efficiencies": [
- null
], - "requester_id": 0,
- "payload": null,
- "filters": null,
- "allocation_id": 0,
- "default_plan_name": "string",
- "id": 0
}
}Create default observation plan requests.
| allocation_id required | integer Observation plan request allocation ID. |
| target_group_ids | Array of integers IDs of groups to share the results of the default observation plan request with. |
| payload | any Content of the default observation plan request. |
{- "allocation_id": 0,
- "target_group_ids": [
- 0
], - "payload": null
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve a single default survey efficiency
| default_survey_efficiency_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "default_observationplan_request": null,
- "default_observationplan_request_id": 0,
- "payload": null,
- "id": 0
}
}Create default survey efficiency requests.
| default_observationplan_request_id required | integer Default observation plan request ID. |
| payload | any Content of the default survey efficiency analysis. |
{- "default_observationplan_request_id": 0,
- "payload": null
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Post a message from a remote facility
| new_status required | string |
| followup_request_id required | integer |
{- "new_status": "string",
- "followup_request_id": 0
}{- "status": "success",
- "message": "string"
}Retrieve followup requests schedule
| sourceID | string Portion of ID to filter on |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at >= startDate |
| endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by created_at <= endDate |
| status | string String to match status of request against |
| priorityThreshold | number Threshold on request priority to include. If provided, filter by payload.priority >= priorityThreshold |
| timeResolution | number Time resolution for scheduler creation in seconds. Defaults to 20. |
| observationStartDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, start time of observation window, otherwise now. |
| observationEndDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, end time of observation window, otherwise 12 hours from now. |
| includeStandards | boolean Include standards in schedule. Defaults to False. |
| standardsOnly | boolean Only request standards in schedule. Defaults to False. |
| standardType | string Origin of the standard stars, defined in config.yaml. Defaults to ESO. |
| magnitudeRange | list lowest and highest magnitude to return, e.g. "(12,9)" |
| output_format | string Output format for schedule. Can be png, pdf, or csv |
{- "status": "error",
- "message": "string",
- "data": { }
}Update a follow-up request
| request_id required | string |
| not_if_classified | boolean If true, the followup request will not be executed if there are any sources within radius with (human-only) classifications. |
| ignore_source_group_ids | Array of integers If there are any sources within radius saved to any of these groups, the followup request will not be executed. |
| target_group_ids | Array of integers IDs of groups to share the results of the followup request with. |
| allocation_id required | integer Followup request allocation ID. |
| source_group_ids | Array of integers IDs of groups to which there must be a source for the object associated with the followup request. |
| status | string Default: "pending submission" The status of the request. |
| not_if_spectra_exist | boolean If true, the followup request will not be executed if there are any sources within radius that have spectra. |
| obj_id required | string ID of the target Obj. |
| not_if_duplicates | boolean If true, the followup request will not be executed if the object already has a pending or completed request of the same allocation. |
| payload | any Content of the followup request. |
| not_if_tns_classified | boolean If true, the followup request will not be executed if any object within radius is already classified as SN in TNS. |
| radius | number Radius of to use when checking constraints. |
{- "not_if_classified": true,
- "ignore_source_group_ids": [
- 0
], - "target_group_ids": [
- 0
], - "allocation_id": 0,
- "source_group_ids": [
- 0
], - "status": "pending submission",
- "not_if_spectra_exist": true,
- "obj_id": "string",
- "not_if_duplicates": true,
- "payload": null,
- "not_if_tns_classified": true,
- "radius": 0
}{- "status": "success",
- "message": "string"
}Submit follow-up request.
| not_if_classified | boolean If true, the followup request will not be executed if there are any sources within radius with (human-only) classifications. |
| ignore_source_group_ids | Array of integers If there are any sources within radius saved to any of these groups, the followup request will not be executed. |
| target_group_ids | Array of integers IDs of groups to share the results of the followup request with. |
| allocation_id required | integer Followup request allocation ID. |
| source_group_ids | Array of integers IDs of groups to which there must be a source for the object associated with the followup request. |
| status | string Default: "pending submission" The status of the request. |
| not_if_spectra_exist | boolean If true, the followup request will not be executed if there are any sources within radius that have spectra. |
| obj_id required | string ID of the target Obj. |
| not_if_duplicates | boolean If true, the followup request will not be executed if the object already has a pending or completed request of the same allocation. |
| payload | any Content of the followup request. |
| not_if_tns_classified | boolean If true, the followup request will not be executed if any object within radius is already classified as SN in TNS. |
| radius | number Radius of to use when checking constraints. |
{- "not_if_classified": true,
- "ignore_source_group_ids": [
- 0
], - "target_group_ids": [
- 0
], - "allocation_id": 0,
- "source_group_ids": [
- 0
], - "status": "pending submission",
- "not_if_spectra_exist": true,
- "obj_id": "string",
- "not_if_duplicates": true,
- "payload": null,
- "not_if_tns_classified": true,
- "radius": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Upload galaxies from GLADE+ catalog. If no file_name or file_url is provided, will look for the GLADE+ catalog in the data directory. If it can't be found, it will download it.
| file_name | string Name of the file containing the galaxies (in the data directory) |
| file_url | string URL of the file containing the galaxies |
{- "file_name": "string",
- "file_url": "string"
}{- "status": "success",
- "message": "string"
}Upload galaxies from ASCII file
| catalogName | string Galaxy catalog name. |
| catalogData | any Catalog data Ascii string |
{- "catalogName": "string",
- "catalogData": null
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "objects": [
- null
], - "catalog_name": "string",
- "name": "string",
- "alt_name": "string",
- "distmpc": 0,
- "distmpc_unc": 0,
- "redshift": 0,
- "redshift_error": 0,
- "sfr_fuv": 0,
- "sfr_w4": 0,
- "mstar": 0,
- "magb": 0,
- "magk": 0,
- "mag_fuv": 0,
- "mag_nuv": 0,
- "mag_w1": 0,
- "mag_w2": 0,
- "mag_w3": 0,
- "mag_w4": 0,
- "a": 0,
- "b2a": 0,
- "pa": 0,
- "btc": 0,
- "id": 0,
- "ra": 0,
- "dec": 0
}
]
}Set an object's host galaxy
| obj_id required | string |
| galaxyName required | string Name of the galaxy to associate with the object |
{- "galaxyName": "string"
}{- "status": "success",
- "message": "string"
}Upload spatial catalog from ASCII file
| catalogName | string Spatial catalog name. |
| catalogData | any Catalog data Ascii string |
{- "catalogName": "string",
- "catalogData": null
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve all galaxies
| catalog_name | string Filter by catalog name (exact match) |
| ra | number RA for spatial filtering (in decimal degrees) |
| dec | number Declination for spatial filtering (in decimal degrees) |
| radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
| galaxyName | string Portion of name to filter on |
| minDistance | number If provided, return only galaxies with a distance of at least this value |
| maxDistance | number If provided, return only galaxies with a distance of at most this value |
| minRedshift | number If provided, return only galaxies with a redshift of at least this value |
| maxRedshift | number If provided, return only galaxies with a redshift of at most this value |
| minMstar | number If provided, return only galaxies with a stellar mass of at least this value |
| maxMstar | number If provided, return only galaxies with a stellar mass of at most this value |
| localizationDateobs | string Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endopoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include galaxies |
| includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
| numPerPage | integer Number of galaxies to return per paginated request. Defaults to 100. Can be no larger than {MAX_GALAXIES}. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
| catalogNamesOnly | boolean Boolean indicating whether to just return catalog names. Defaults to false. |
| returnProbability | boolean Boolean indicating whether to return probability density. Defaults to false. |
| sortBy | string Column to sort by. Can be one of the following: distmpc, redshift, name, mstar, prob, mstar_prob_weighted, sfr_fuv, magb, magk. Defaults to no sorting unless a localization and catalog are provided, then defaults to mstar_prob_weighted. |
| sortOrder | string Sort order. Can be one of the following: asc, desc. Defaults to None unless a localization and catalog are provided, then defaults to desc. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "objects": [
- null
], - "catalog_name": "string",
- "name": "string",
- "alt_name": "string",
- "distmpc": 0,
- "distmpc_unc": 0,
- "redshift": 0,
- "redshift_error": 0,
- "sfr_fuv": 0,
- "sfr_w4": 0,
- "mstar": 0,
- "magb": 0,
- "magk": 0,
- "mag_fuv": 0,
- "mag_nuv": 0,
- "mag_w1": 0,
- "mag_w2": 0,
- "mag_w3": 0,
- "mag_w4": 0,
- "a": 0,
- "b2a": 0,
- "pa": 0,
- "btc": 0,
- "id": 0,
- "ra": 0,
- "dec": 0
}
]
}Ingest a Galaxy catalog
| catalog_name | string Galaxy catalog name. |
| catalog_data | Array of any Galaxy catalog data |
{- "catalog_name": "string",
- "catalog_data": [
- null
]
}{- "status": "success",
- "message": "string"
}Ingest a Spatial Catalog
| catalog_name | string Spatial catalog name. |
| catalog_data | Array of any Spatial catalog data |
{- "catalog_name": "string",
- "catalog_data": [
- null
]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Compute instrument field probabilities for a skymap
| dateobs required | string |
| Instrument ID required | integer |
| localization_name required | string Localization map name |
| integrated_probability | float Cumulative integrated probability threshold |
{- "status": "success",
- "message": "string"
}Add log messages from an instrument
| instrument_id required | integer The instrument ID to post logs for |
| start_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
| end_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
| logs required | object Nested JSON containing the log messages. |
{- "start_date": "string",
- "end_date": "string",
- "logs": { }
}{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Update the status of an instrument
| instrument_id required | integer The instrument ID to update the status for |
| status required | string The status of the instrument |
{- "status": "string"
}{- "status": "success",
- "message": "string"
}Retrieve an instrument
| instrument_id required | integer |
| includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
| includeGeoJSONSummary | boolean Boolean indicating whether to include associated GeoJSON summary bounding box. Defaults to false. |
| includeRegion | boolean Boolean indicating whether to include associated DS9 region. Defaults to false. |
| localizationDateobs | string Include fields within a given localization.
Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
{- "status": "success",
- "message": "string",
- "data": {
- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2019-08-24T14:15:22Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true,
- "id": 0
}
}Update instrument
| instrument_id required | integer |
| telescope | any or null The Telescope that hosts the Instrument. |
| photometry | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| allocations | Array of any |
| observing_runs | Array of any |
| observations | Array of any |
| queued_observations | Array of any |
| fields | Array of any |
| tiles | Array of any |
| plans | Array of any |
| logs | Array of any |
| tnsrobots | Array of any |
| name required | string Instrument name. |
| type required | string <= 20 characters Enum: "imager" "spectrograph" "imaging spectrograph" Instrument type, one of Imager, Spectrograph, or Imaging Spectrograph. |
| band | string or null The spectral band covered by the instrument (e.g., Optical, IR). |
| telescope_id required | integer The ID of the Telescope that hosts the Instrument. |
| filters | Array of any List of filters on the instrument (if any). |
| sensitivity_data | any or null JSON describing the filters on the instrument and the filter's corresponding limiting magnitude and exposure time. |
| configuration_data | any or null JSON describing instrument configuration properties such as instrument overhead, filter change time, readout, etc. |
| status | any or null JSON describing the latest status of the instrument. |
| last_status_update | string or null <date-time> The time at which the status was last updated. |
| api_classname | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's API class. |
| api_classname_obsplan | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's ObservationPlan API class. |
| listener_classname | string or null <= 12 characters Value: "SEDMListener" Name of the instrument's listener class. |
| treasuremap_id | integer or null treasuremap.space API ID for this instrument |
| tns_id | integer or null TNS API ID for this instrument |
| region | string or null Instrument astropy.regions representation. |
| has_fields | boolean Whether the instrument has fields or not. |
| has_region | boolean Whether the instrument has a region or not. |
{- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2019-08-24T14:15:22Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true
}{- "status": "success",
- "message": "string"
}Delete an instrument
| instrument_id required | integer |
| fieldsOnly | boolean Boolean indicating whether to just delete the associated fields. Defaults to false. |
{- "status": "success",
- "message": "string"
}Retrieve all instruments
| name | string Filter by name (exact match) |
| includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
| includeGeoJSONSummary | boolean Boolean indicating whether to include associated GeoJSON summary bounding box. Defaults to false. |
| includeRegion | boolean Boolean indicating whether to include associated DS9 region. Defaults to false. |
| ignoreCache | boolean Boolean indicating whether to ignore field caching. Defaults to false. |
| localizationDateobs | string Include fields within a given localization.
Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
| airmassTime | string Time to use for airmass calculation in
ISO 8601 format ( |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": null,
- "configuration_data": null,
- "status": null,
- "last_status_update": "2019-08-24T14:15:22Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true,
- "id": 0
}
]
}Add a new instrument
| telescope | any or null The Telescope that hosts the Instrument. |
| photometry | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| allocations | Array of any |
| observing_runs | Array of any |
| observations | Array of any |
| queued_observations | Array of any |
| fields | Array of any |
| tiles | Array of any |
| plans | Array of any |
| logs | Array of any |
| tnsrobots | Array of any |
| name required | string Instrument name. |
| type required | string <= 20 characters Enum: "imager" "spectrograph" "imaging spectrograph" Instrument type, one of Imager, Spectrograph, or Imaging Spectrograph. |
| band | string or null The spectral band covered by the instrument (e.g., Optical, IR). |
| telescope_id required | integer The ID of the Telescope that hosts the Instrument. |
| filters | Array of strings Default: [] Items Enum: "bessellux" "bessellb" "bessellv" "bessellr" "besselli" "standard::u" "standard::b" "standard::v" "standard::r" "standard::i" "desu" "desg" "desr" "desi" "desz" "desy" "sdssu" "sdssg" "sdssr" "sdssi" "sdssz" "f435w" "f475w" "f555w" "f606w" "f625w" "f775w" "f850lp" "nicf110w" "nicf160w" "f098m" "f105w" "f110w" "f125w" "f127m" "f139m" "f140w" "f153m" "f160w" "f218w" "f225w" "f275w" "f300x" "f336w" "f350lp" "f390w" "f689m" "f763m" "f845m" "f438w" "uvf475w" "uvf555w" "uvf606w" "uvf625w" "uvf775w" "uvf814w" "uvf850lp" "kepler" "cspb" "csphs" "csphd" "cspjs" "cspjd" "cspv3009" "cspv3014" "cspv9844" "cspys" "cspyd" "cspg" "cspi" "cspk" "cspr" "cspu" "f070w" "f090w" "f115w" "f150w" "f200w" "f277w" "f356w" "f444w" "f140m" "f162m" "f182m" "f210m" "f250m" "f300m" "f335m" "f360m" "f410m" "f430m" "f460m" "f480m" "f560w" "f770w" "f1000w" "f1130w" "f1280w" "f1500w" "f1800w" "f2100w" "f2550w" "f1065c" "f1140c" "f1550c" "f2300c" "lsstu" "lsstg" "lsstr" "lssti" "lsstz" "lssty" "keplercam::us" "keplercam::b" "keplercam::v" "keplercam::r" "keplercam::i" "4shooter2::us" "4shooter2::b" "4shooter2::v" "4shooter2::r" "4shooter2::i" "f062" "f087" "f106" "f129" "f158" "f184" "f213" "f146" "ztfg" "ztfr" "ztfi" "uvot::b" "uvot::u" "uvot::uvm2" "uvot::uvw1" "uvot::uvw2" "uvot::v" "uvot::white" "ps1::open" "ps1::g" "ps1::r" "ps1::i" "ps1::z" "ps1::y" "ps1::w" "atlasc" "atlaso" "2massj" "2massh" "2massks" "gaia::gbp" "gaia::g" "gaia::grp" "gaia::grvs" "tess" "gotob" "gotog" "gotol" "gotor" "swiftxrt" "nicerxti" List of filters on the instrument (if any). |
object or null JSON describing the filters on the instrument and the filter's corresponding limiting magnitude and exposure time. | |
object or null JSON describing instrument configuration properties such as instrument overhead, filter change time, readout, etc. | |
| status | any or null JSON describing the latest status of the instrument. |
| last_status_update | string or null <date-time> The time at which the status was last updated. |
| api_classname | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's API class. |
| api_classname_obsplan | string or null <= 17 characters Enum: "MMAAPI" "GENERICAPI" "SLACKAPI" "ATLASAPI" "GROWTHINDIAMMAAPI" "KAITAPI" "SEDMAPI" "SEDMV2API" "IOOAPI" "IOIAPI" "SPRATAPI" "SINISTROAPI" "SPECTRALAPI" "FLOYDSAPI" "MUSCATAPI" "NICERAPI" "PS1API" "SOARGHTSAPI" "SOARGHTSIMAGERAPI" "SOARTSPECAPI" "UVOTXRTAPI" "UVOTXRTMMAAPI" "TESSAPI" "TRTAPI" "WINTERAPI" "ZTFAPI" "ZTFMMAAPI" Name of the instrument's ObservationPlan API class. |
| listener_classname | string or null <= 12 characters Value: "SEDMListener" Name of the instrument's listener class. |
| treasuremap_id | integer or null treasuremap.space API ID for this instrument |
| tns_id | integer or null TNS API ID for this instrument |
| region | string or null Instrument astropy.regions representation. |
| has_fields | boolean Whether the instrument has fields or not. |
| has_region | boolean Whether the instrument has a region or not. |
| field_data | dict List of ID, RA, and Dec for each field. |
| field_region | str Serialized version of a regions.Region describing the shape of the instrument field. Note: should only include field_region or field_fov_type. |
| references | dict List of filter, and limiting magnitude for each reference. |
| field_fov_type | str Option for instrument field shape. Must be either circle or rectangle. Note: should only include field_region or field_fov_type. |
| field_fov_attributes | list Option for instrument field shape parameters. Single float radius in degrees in case of circle or list of two floats (height and width) in case of a rectangle. |
{- "telescope": null,
- "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "allocations": [
- null
], - "observing_runs": [
- null
], - "observations": [
- null
], - "queued_observations": [
- null
], - "fields": [
- null
], - "tiles": [
- null
], - "plans": [
- null
], - "logs": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "type": "imager",
- "band": "string",
- "telescope_id": 0,
- "filters": [
- null
], - "sensitivity_data": {
- "filter_name": "bessellux"
}, - "configuration_data": {
- "filter_name": {
- "filt_change_time": null,
- "readout": null,
- "overhead_per_exposure": null,
- "slew_rate": null
}
}, - "status": null,
- "last_status_update": "2019-08-24T14:15:22Z",
- "api_classname": "MMAAPI",
- "api_classname_obsplan": "MMAAPI",
- "listener_classname": "SEDMListener",
- "treasuremap_id": 0,
- "tns_id": 0,
- "region": "string",
- "has_fields": true,
- "has_region": true,
- "field_data": null,
- "field_region": null,
- "references": null,
- "field_fov_type": null,
- "field_fov_attributes": null
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve a ground velocity measurement for the earthquake.
| earthquake_id required | string |
| mma_detector_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "event_id": 0,
- "detector_id": 0,
- "rfamp": 0,
- "lockloss": 0,
- "id": 0
}
}Retrieve multiple Earthquake events
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by date >= startDate |
| endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by date <= endDate |
| statusKeep | string Earthquake Status to match against |
| statusRemove | string Earthquake Status to filter out |
| numPerPage | integer Number of earthquakes. Defaults to 100. |
| pageNumber | integer Page number for iterating through all earthquakes. Defaults to 1 |
Ingest EarthquakeEvent
| sent_by | any or null The user that saved this EarthquakeEvent |
| notices | Array of any |
| predictions | Array of any |
| measurements | Array of any |
| comments | Array of any |
| reminders | Array of any |
| sent_by_id required | integer The ID of the User who created this GcnTag. |
| event_id required | string |
| event_uri | string or null |
| status | string The status of the earthquake event. |
{- "sent_by": null,
- "notices": [
- null
], - "predictions": [
- null
], - "measurements": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "sent_by_id": 0,
- "event_id": "string",
- "event_uri": "string",
- "status": "string"
}{- "status": "success",
- "message": "string"
}Retrieve all comments associated with specified resource
| associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
]
}Update a comment
| associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" "shift" What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" "shift" The ID of the source or spectrum that the comment is posted to. This would be a string for an object ID or an integer for a spectrum, gcn_event or shift. |
| comment_id required | integer |
| obj | any or null The Comment's Obj. |
| author | any or null Comment's author. |
| groups | Array of any |
| obj_id required | string ID of the Comment's Obj. |
| text required | string Comment body. |
| attachment_name | string or null Filename of the attachment. |
| _attachment_path | string or null file path where the data of the attachment is saved. |
| origin | string or null Comment origin. |
| bot | boolean Boolean indicating whether comment was posted via a bot (token-based request). |
| attachment_bytes | string or null Binary representation of the attachment. |
| author_id required | integer ID of the Comment author's User instance. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. |
{- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Post a comment
| associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" "earthquake" "shift" What underlying data the comment is on: "source" or "spectrum" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" "earthquake" "shift" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
| text required | string |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. Defaults to all of requesting user's groups. |
object |
{- "text": "string",
- "group_ids": [
- 0
], - "attachment": {
- "body": "string",
- "name": "string"
}
}{- "status": "success",
- "message": "string",
- "data": {
- "comment_id": 0
}
}Delete a comment
| associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event. |
| comment_id required | integer |
{- "status": "success",
- "message": "string"
}Retrieve a comment
| associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
| comment_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
}Update a comment
| associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" "shift" What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" "shift" The ID of the source or spectrum that the comment is posted to. This would be a string for an object ID or an integer for a spectrum, gcn_event or shift. |
| comment_id required | integer |
| obj | any or null The Comment's Obj. |
| author | any or null Comment's author. |
| groups | Array of any |
| obj_id required | string ID of the Comment's Obj. |
| text required | string Comment body. |
| attachment_name | string or null Filename of the attachment. |
| _attachment_path | string or null file path where the data of the attachment is saved. |
| origin | string or null Comment origin. |
| bot | boolean Boolean indicating whether comment was posted via a bot (token-based request). |
| attachment_bytes | string or null Binary representation of the attachment. |
| author_id required | integer ID of the Comment author's User instance. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. |
{- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Delete a comment
| associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event. |
| comment_id required | integer |
{- "status": "success",
- "message": "string"
}Download comment attachment
| associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" What underlying data the comment is on: "sources" or "spectra". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum. |
| comment_id required | integer |
| download | boolean If true, download the attachment; else return file data as text. True by default. |
| preview | boolean If true, return an attachment preview. False by default. |
Download comment attachment
| associated_resource_type required | string Enum: "sources" "spectrum" "gcn_event" What underlying data the comment is on: "sources" or "spectra". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source or spectrum that the comment is posted to. This would be a string for a source ID or an integer for a spectrum. |
| comment_id required | integer |
| download | boolean If true, download the attachment; else return file data as text. True by default. |
| preview | boolean If true, return an attachment preview. False by default. |
create attachments for a batch of comments with attachment_bytes
| numPerPage | integer Number of comments to check for updates. Defaults to 100. Max 500. |
| pageNumber | integer Page number for iterating through all comments. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}Retrieve all comments associated with specified resource
| associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
]
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}Retrieve a comment
| associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
| comment_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
}Retrieve a reminder
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" "earthquake" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake" |
| resource_id required | string The ID of the source, spectrum, gcn_event or shift that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event |
| reminder_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
}Retrieve all reminders associated with specified resource
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}Retrieve all spectra associated with an Object
| obj_id required | string ID of the object to retrieve spectra for |
| normalization | string what normalization is needed for the spectra (e.g., "median"). If omitted, returns the original spectrum. Options for normalization are:
|
| sortBy | string The column to order the spectra by. Defaults to observed_at. Options are: observed_at, created_at |
| sortOrder | string The order to sort the spectra by. Defaults to asc. Options are: asc, desc |
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string",
- "spectra": [
- {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
]
}
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}Retrieve an annotation
| associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
| annotation_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
}{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
}Update spectrum
| spectrum_id required | integer |
| observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
| type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
| instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
| label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
| wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
| external_observer | string or null Default: null Free text provided as an external observer |
| followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
| origin | string Origin of the spectrum. |
| obj_id required | string ID of this Spectrum's Obj. |
| group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
| external_reducer | string or null Default: null Free text provided as an external reducer |
| altdata | any Miscellaneous alternative metadata. |
| pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
| observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
| assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
| errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
| fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
| external_pi | string or null Default: null Free text provided as an external PI |
| reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
| units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
{- "observed_at": "2019-08-24T14:15:22Z",
- "type": "source",
- "instrument_id": 0,
- "label": "string",
- "wavelengths": [
- 0
], - "external_observer": null,
- "followup_request_id": 0,
- "origin": "string",
- "obj_id": "string",
- "group_ids": [ ],
- "external_reducer": null,
- "altdata": null,
- "pi": [ ],
- "observed_by": [ ],
- "assignment_id": 0,
- "errors": [
- 0
], - "fluxes": [
- 0
], - "external_pi": null,
- "reduced_by": [ ],
- "units": "string"
}{- "status": "success",
- "message": "string"
}Retrieve multiple spectra with given criteria
| minimalPayload | boolean If true, return only the minimal metadata about each spectrum, instead of returning the potentially large payload that includes wavelength/flux and also comments and annotations. The metadata that is always included is: id, obj_id, owner_id, origin, type, label, observed_at, created_at, modified, instrument_id, instrument_name, original_file_name, followup_request_id, assignment_id, and altdata. |
| observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed before this time. |
| observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed after this time. |
| objID | string Return any spectra on an object with ID that has a (partial) match to this argument (i.e., the given argument is "in" the object's ID). |
| instrumentIDs | any If provided, filter only spectra observed with one of these instrument IDs. |
| groupIDs | list If provided, filter only spectra saved to one of these group IDs. |
| followupRequestIDs | list If provided, filter only spectra associate with these followup request IDs. |
| assignmentIDs | list If provided, filter only spectra associate with these assignment request IDs. |
| origin | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
| label | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
| type | string Return spectra of the given type or types (match multiple values using a comma separated list). Types of spectra are defined in the config, e.g., source, host or host_center. |
| commentsFilter | Array of strings Comma-separated string of comment text to filter for spectra matching. |
| commentsFilterAuthor | string Comma separated string of authors. Only comments from these authors are used when filtering with the commentsFilter. |
| commentsFilterBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments before this time. |
| commentsFilterAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments after this time. |
Upload spectrum
| observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
| type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
| instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
| label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
| wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
| external_observer | string or null Default: null Free text provided as an external observer |
| followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
| origin | string Origin of the spectrum. |
| obj_id required | string ID of this Spectrum's Obj. |
| group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
| external_reducer | string or null Default: null Free text provided as an external reducer |
| altdata | any Miscellaneous alternative metadata. |
| pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
| observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
| assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
| errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
| fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
| external_pi | string or null Default: null Free text provided as an external PI |
| reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
| units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
{- "observed_at": "2019-08-24T14:15:22Z",
- "type": "source",
- "instrument_id": 0,
- "label": "string",
- "wavelengths": [
- 0
], - "external_observer": null,
- "followup_request_id": 0,
- "origin": "string",
- "obj_id": "string",
- "group_ids": [ ],
- "external_reducer": null,
- "altdata": null,
- "pi": [ ],
- "observed_by": [ ],
- "assignment_id": 0,
- "errors": [
- 0
], - "fluxes": [
- 0
], - "external_pi": null,
- "reduced_by": [ ],
- "units": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Parse spectrum from ASCII file
| flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
| wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
| ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
| fluxerr_column | integer or null Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
{- "flux_column": 1,
- "wave_column": 0,
- "ascii": "string",
- "fluxerr_column": null
}{- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string"
}Upload spectrum from ASCII file
| observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
| type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source', 'host', 'host_center'. Defaults to 'fsource'. |
| instrument_id required | integer The ID of the instrument that took the spectrum. |
| label | string User defined label to be placed in plot legends, instead of the default |
| external_observer | string or null Default: null Free text provided as an external observer |
| followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
| flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
| obj_id required | string The ID of the object that the spectrum is of. |
| group_ids | Array of integers The IDs of the groups to share this spectrum with. |
| external_reducer | string or null Default: null Free text provided as an external reducer |
| pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
| fluxerr_column | integer or null Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
| observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
| filename required | string The original filename (for bookkeeping purposes). |
| assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
| wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
| ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
| external_pi | string or null Default: null Free text provided as an external PI |
| reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
{- "observed_at": "2019-08-24T14:15:22Z",
- "type": "source",
- "instrument_id": 0,
- "label": "string",
- "external_observer": null,
- "followup_request_id": 0,
- "flux_column": 1,
- "obj_id": "string",
- "group_ids": [
- 0
], - "external_reducer": null,
- "pi": [ ],
- "fluxerr_column": null,
- "observed_by": [ ],
- "filename": "string",
- "assignment_id": 0,
- "wave_column": 0,
- "ascii": "string",
- "external_pi": null,
- "reduced_by": [ ]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Create synthetic photometry from a spectrum
| spectrum_id required | integer |
| filters required | list List of filters |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
}Retrieve spectra for given instrument within date range
| instrument_ids | list of integers Instrument id numbers of spectrum. If None, retrieve for all instruments. |
| min_date | ISO UTC date string Minimum UTC date of range in ISOT format. If None, open ended range. |
| max_date | ISO UTC date string Maximum UTC date of range in ISOT format. If None, open ended range. |
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string",
- "spectra": [
- {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
]
}
}{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
}Update spectrum
| spectrum_id required | integer |
| observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
| type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
| instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
| label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
| wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
| external_observer | string or null Default: null Free text provided as an external observer |
| followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
| origin | string Origin of the spectrum. |
| obj_id required | string ID of this Spectrum's Obj. |
| group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
| external_reducer | string or null Default: null Free text provided as an external reducer |
| altdata | any Miscellaneous alternative metadata. |
| pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
| observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
| assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
| errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
| fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
| external_pi | string or null Default: null Free text provided as an external PI |
| reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
| units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
{- "observed_at": "2019-08-24T14:15:22Z",
- "type": "source",
- "instrument_id": 0,
- "label": "string",
- "wavelengths": [
- 0
], - "external_observer": null,
- "followup_request_id": 0,
- "origin": "string",
- "obj_id": "string",
- "group_ids": [ ],
- "external_reducer": null,
- "altdata": null,
- "pi": [ ],
- "observed_by": [ ],
- "assignment_id": 0,
- "errors": [
- 0
], - "fluxes": [
- 0
], - "external_pi": null,
- "reduced_by": [ ],
- "units": "string"
}{- "status": "success",
- "message": "string"
}Retrieve multiple spectra with given criteria
| minimalPayload | boolean If true, return only the minimal metadata about each spectrum, instead of returning the potentially large payload that includes wavelength/flux and also comments and annotations. The metadata that is always included is: id, obj_id, owner_id, origin, type, label, observed_at, created_at, modified, instrument_id, instrument_name, original_file_name, followup_request_id, assignment_id, and altdata. |
| observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed before this time. |
| observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed after this time. |
| objID | string Return any spectra on an object with ID that has a (partial) match to this argument (i.e., the given argument is "in" the object's ID). |
| instrumentIDs | any If provided, filter only spectra observed with one of these instrument IDs. |
| groupIDs | list If provided, filter only spectra saved to one of these group IDs. |
| followupRequestIDs | list If provided, filter only spectra associate with these followup request IDs. |
| assignmentIDs | list If provided, filter only spectra associate with these assignment request IDs. |
| origin | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
| label | string Return any spectra that have an origin with a (partial) match to any of the values in this comma separated list. |
| type | string Return spectra of the given type or types (match multiple values using a comma separated list). Types of spectra are defined in the config, e.g., source, host or host_center. |
| commentsFilter | Array of strings Comma-separated string of comment text to filter for spectra matching. |
| commentsFilterAuthor | string Comma separated string of authors. Only comments from these authors are used when filtering with the commentsFilter. |
| commentsFilterBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments before this time. |
| commentsFilterAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, only return sources that have comments after this time. |
Upload spectrum
| observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
| type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source''host''host_center'. Defaults to 'fsource'. |
| instrument_id required | integer ID of the Instrument that acquired the Spectrum. |
| label | string User defined label (can be used to replace default instrument/date labeling on plot legends). |
| wavelengths required | Array of numbers Wavelengths of the spectrum [Angstrom]. |
| external_observer | string or null Default: null Free text provided as an external observer |
| followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
| origin | string Origin of the spectrum. |
| obj_id required | string ID of this Spectrum's Obj. |
| group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
| external_reducer | string or null Default: null Free text provided as an external reducer |
| altdata | any Miscellaneous alternative metadata. |
| pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
| observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
| assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
| errors | Array of numbers Errors on the fluxes of the spectrum [F_lambda, same units as |
| fluxes required | Array of numbers Flux of the Spectrum [F_lambda, arbitrary units]. |
| external_pi | string or null Default: null Free text provided as an external PI |
| reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
| units | string Units of the fluxes/errors. Options are Jy, AB, or erg/s/cm/cm/AA). |
{- "observed_at": "2019-08-24T14:15:22Z",
- "type": "source",
- "instrument_id": 0,
- "label": "string",
- "wavelengths": [
- 0
], - "external_observer": null,
- "followup_request_id": 0,
- "origin": "string",
- "obj_id": "string",
- "group_ids": [ ],
- "external_reducer": null,
- "altdata": null,
- "pi": [ ],
- "observed_by": [ ],
- "assignment_id": 0,
- "errors": [
- 0
], - "fluxes": [
- 0
], - "external_pi": null,
- "reduced_by": [ ],
- "units": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Parse spectrum from ASCII file
| flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
| wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
| ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
| fluxerr_column | integer or null Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
{- "flux_column": 1,
- "wave_column": 0,
- "ascii": "string",
- "fluxerr_column": null
}{- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string"
}Upload spectrum from ASCII file
| observed_at required | string <date-time> The ISO UTC time the spectrum was taken. |
| type | string Enum: "source" "host" "host_center" Type of spectrum. One of: 'source', 'host', 'host_center'. Defaults to 'fsource'. |
| instrument_id required | integer The ID of the instrument that took the spectrum. |
| label | string User defined label to be placed in plot legends, instead of the default |
| external_observer | string or null Default: null Free text provided as an external observer |
| followup_request_id | integer ID of the Followup request that generated this spectrum, if any. |
| flux_column | integer Default: 1 The 0-based index of the ASCII column corresponding to the flux values of the spectrum (default 1). |
| obj_id required | string The ID of the object that the spectrum is of. |
| group_ids | Array of integers The IDs of the groups to share this spectrum with. |
| external_reducer | string or null Default: null Free text provided as an external reducer |
| pi | Array of integers Default: [] IDs of the Users who are PI of this Spectrum, or to use as points of contact given an external PI. |
| fluxerr_column | integer or null Default: null The 0-based index of the ASCII column corresponding to the flux error values of the spectrum (default None). If a column for errors is provided, set to the corresponding 0-based column number, otherwise, it will be ignored. |
| observed_by | Array of integers Default: [] IDs of the Users who observed this Spectrum, or to use as points of contact given an external observer. |
| filename required | string The original filename (for bookkeeping purposes). |
| assignment_id | integer ID of the classical assignment that generated this spectrum, if any. |
| wave_column | integer Default: 0 The 0-based index of the ASCII column corresponding to the wavelength values of the spectrum (default 0). |
| ascii required | string The content of the ASCII file to be parsed. The file can optionally contain a header which will be parsed and stored. The lines that make up the ASCII header must appear at the beginning of the file and all be formatted the same way within a single file. They can be formatted in one of two ways.
Example of format 1:
Example of format 2:
The data must be at least 2 column ascii (wavelength, flux). If flux errors are provided in an additional column, the column must be specified in the call. If more than 2 columns are given, by default the first two are interpreted as (wavelength, flux). The column indices of each of these arguments can be controlled by passing the integer column index to the POST JSON. Examples of valid data sections: Many-column ASCII:
3-column ASCII:
2-column ASCII:
2-column ASCII:
|
| external_pi | string or null Default: null Free text provided as an external PI |
| reduced_by | Array of integers Default: [] IDs of the Users who reduced this Spectrum, or to use as points of contact given an external reducer. |
{- "observed_at": "2019-08-24T14:15:22Z",
- "type": "source",
- "instrument_id": 0,
- "label": "string",
- "external_observer": null,
- "followup_request_id": 0,
- "flux_column": 1,
- "obj_id": "string",
- "group_ids": [
- 0
], - "external_reducer": null,
- "pi": [ ],
- "fluxerr_column": null,
- "observed_by": [ ],
- "filename": "string",
- "assignment_id": 0,
- "wave_column": 0,
- "ascii": "string",
- "external_pi": null,
- "reduced_by": [ ]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve spectra for given instrument within date range
| instrument_ids | list of integers Instrument id numbers of spectrum. If None, retrieve for all instruments. |
| min_date | ISO UTC date string Minimum UTC date of range in ISOT format. If None, open ended range. |
| max_date | ISO UTC date string Maximum UTC date of range in ISOT format. If None, open ended range. |
{- "status": "success",
- "message": "string",
- "data": {
- "obj_id": "string",
- "spectra": [
- {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
]
}
}Submit a (classification) spectrum to TNS
| spectrum_id required | integer |
| tnsrobotID required | int SkyPortal TNS Robot ID |
| classificationID | string Classification ID (see TNS documentation at https://www.wis-tns.org/content/tns-getting-started for options) |
| classifiers | string List of those performing classification. |
| spectrumType | string Type of spectrum that this is. Valid options are: ['object', 'host', 'sky', 'arcs', 'synthetic'] |
| spectrumComment | string Comment on the spectrum. |
| classificationComment | string Comment on the classification. |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "instrument": null,
- "groups": [
- null
], - "pis": [
- null
], - "reducers": [
- null
], - "observers": [
- null
], - "followup_request": null,
- "assignment": null,
- "owner": null,
- "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "wavelengths": [
- 0
], - "fluxes": [
- 0
], - "errors": [
- 0
], - "units": "string",
- "obj_id": "string",
- "observed_at": "2019-08-24T14:15:22Z",
- "origin": "string",
- "type": "source",
- "label": "string",
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "altdata": null,
- "original_file_string": "string",
- "original_file_filename": "string",
- "owner_id": 0,
- "id": 0
}
}Retrieve all comments associated with specified resource
| associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
]
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}Retrieve a comment
| associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
| comment_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
}Retrieve a reminder
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" "earthquake" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake" |
| resource_id required | string The ID of the source, spectrum, gcn_event or shift that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event |
| reminder_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
}Retrieve all reminders associated with specified resource
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}calculate healpix values for a batch of sources without a Healpix value
| numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
| pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}Get a summary of all the activity of shift users on skyportal for a given period
| shift_id required | integer |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}Copy all photometry points from one source to another
| target_id required | string The obj_id of the target Source (to which the photometry is being copied to) |
| group_ids required | Array of integers List of IDs of groups to give photometry access to |
| origin_id required | string The ID of the Source's Obj the photometry is being copied from |
{- "group_ids": [
- 0
], - "origin_id": "string"
}{- "status": "success",
- "message": "string"
}Retrieve offset stars to aid in spectroscopy
| obj_id required | string |
| facility | string Enum: "Keck" "Shane" "P200" Which facility to generate the starlist for |
| num_offset_stars | integer [ 0 .. 10 ] Requested number of offset stars (set to zero to get starlist of just the source itself) |
| obstime | string datetime of observation in isoformat (e.g. 2020-12-30T12:34:10) |
| use_ztfref | boolean Use ZTFref catalog for offset star positions, otherwise Gaia DR3 |
{- "status": "success",
- "message": "string",
- "data": {
- "facility": "Keck",
- "starlist_str": "string",
- "starlist_info": [
- {
- "str": "string",
- "ra": 0.1,
- "dec": 0.1,
- "name": "string",
- "dras": "string",
- "ddecs": "string",
- "mag": 0.1
}
], - "ra": 0.1,
- "dec": 0.1,
- "queries_issued": 0,
- "noffsets": 0,
- "query": "string"
}
}Generate a PDF/PNG finding chart to aid in spectroscopy
| obj_id required | string |
| imsize | float [ 2 .. 15 ] Image size in arcmin (square) |
| facility | string Enum: "Keck" "Shane" "P200" |
| image_source | string Enum: "desi" "dss" "ztfref" "ps1" Source of the image used in the finding chart. Defaults to ps1 |
| use_ztfref | boolean Use ZTFref catalog for offset star positions, otherwise DR3 |
| obstime | string datetime of observation in isoformat (e.g. 2020-12-30T12:34:10) |
| type | string Enum: "png" "pdf" output type |
| num_offset_stars | integer [ 0 .. 4 ] output desired number of offset stars [0,5] (default: 3) |
{- "status": "error",
- "message": "string",
- "data": { }
}Retrieve an object's classifications
| obj_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "taxonomy": null,
- "author": null,
- "obj": null,
- "groups": [
- null
], - "votes": [
- null
], - "classification": "string",
- "origin": "string",
- "taxonomy_id": 0,
- "probability": 0,
- "ml": true,
- "author_id": 0,
- "author_name": "string",
- "obj_id": "string",
- "id": 0
}
]
}Delete all of an object's classifications
| classification_id required | integer |
| label | boolean or null Add label associated with classification. |
{- "label": true
}{- "status": "success",
- "message": "string"
}Retrieve basic info on Groups that an Obj is saved to
| obj_id required | integer |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
]
}Note that a source has been labelled.
| obj_id required | string ID of object to indicate source labelling for |
| groupIds required | Array of integers List of IDs of groups to indicate labelling for |
{- "groupIds": [
- 0
]
}{- "status": "success",
- "message": "string"
}Delete source labels
| obj_id required | string |
| groupIds required | Array of integers List of IDs of groups to indicate scanning for |
{- "groupIds": [
- 0
]
}{- "status": "success",
- "message": "string"
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}Retrieve an annotation
| associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
| annotation_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
}Retrieve a source
| obj_id required | string Source ID |
| TNSname | string TNS name for the source |
| includePhotometry | boolean Boolean indicating whether to include associated photometry. Defaults to false. |
| deduplicatePhotometry | boolean Boolean indicating whether to deduplicate photometry. Defaults to false. |
| includeComments | boolean Boolean indicating whether to include comment metadata in response. Defaults to false. |
| includeAnalyses | boolean Boolean indicating whether to include associated analyses. Defaults to false. |
| includePhotometryExists | boolean Boolean indicating whether to return if a source has any photometry points. Defaults to false. |
| includeSpectrumExists | boolean Boolean indicating whether to return if a source has a spectra. Defaults to false. |
| includeCommentExists | boolean Boolean indicating whether to return if a source has a comment. Defaults to false. |
| includePeriodExists | boolean Boolean indicating whether to return if a source has a period set. Defaults to false. |
| includeThumbnails | boolean Boolean indicating whether to include associated thumbnails. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}
}Update a source
| obj_id required | string |
| host | any or null The Galaxy associated with this source. |
| comments | Array of any |
| reminders | Array of any |
| comments_on_spectra | Array of any |
| reminders_on_spectra | Array of any |
| annotations | Array of any |
| annotations_on_spectra | Array of any |
| annotations_on_photometry | Array of any |
| classifications | Array of any |
| photometry | Array of any |
| photstats | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| thumbnails | Array of any |
| followup_requests | Array of any |
| assignments | Array of any |
| obj_notifications | Array of any |
| obj_analyses | Array of any |
| sources_in_gcns | Array of any |
| tns_submissions | Array of any |
| ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
| dec_dis | number or null J2000 Declination at discovery time [deg]. |
| ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
| dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
| offset | number or null Offset from nearest static object [arcsec]. |
| redshift | number or null Redshift. |
| redshift_error | number or null Redshift error. |
| redshift_origin | string or null Redshift source. |
| redshift_history | any or null Record of who set which redshift values and when. |
| host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
| summary | string or null Summary of the obj. |
| summary_history | any or null Record of the summaries generated and written about this obj |
| altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
| dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
| mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
| e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
| transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
| varstar | boolean or null Boolean indicating whether the object is a variable star. |
| is_roid | boolean or null Boolean indicating whether the object is a moving object. |
| mpc_name | string or null Minor planet center name. |
| gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
| tns_name | string or null Transient Name Server name. |
| tns_info | any or null TNS info in JSON format |
| score | number or null Machine learning score. |
| origin | string or null Origin of the object. |
| alias | any or null Alternative names for this object. |
| internal_key | string Internal key used for secure websocket messaging. |
| detect_photometry_count | integer or null How many times the object was detected above :math: |
| ra | number or null |
| dec | number or null |
| candidates | Array of any |
| sources | Array of any |
| users | Array of any |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}{- "status": "success",
- "message": "string"
}Retrieve all sources
| ra | number RA for spatial filtering (in decimal degrees) |
| dec | number Declination for spatial filtering (in decimal degrees) |
| radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
| sourceID | string Portion of ID or TNS name to filter on |
| rejectedSourceIDs | str Comma-separated string of object IDs not to be returned, useful in cases where you are looking for new sources passing a query. |
| simbadClass | string Simbad class to filter on |
| alias | Array of any additional name for the same object |
| origin | string who posted/discovered this source |
| hasTNSname | boolean If true, return only those matches with TNS names |
| hasBeenLabelled | boolean If true, return only those objects which have been labelled |
| hasNotBeenLabelled | boolean If true, return only those objects which have not been labelled |
| currentUserLabeller | boolean If true and one of hasBeenLabeller or hasNotBeenLabelled is true, return only those objects which have been labelled/not labelled by the current user. Otherwise, return results for all users. |
| numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
| totalMatches | integer Used only in the case of paginating query results - if provided, this allows for avoiding a potentially expensive query.count() call. |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by PhotStat.first_detected_mjd >= startDate |
| endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by PhotStat.last_detected_mjd <= endDate |
| requireDetections | boolean Require startDate, endDate, and numberDetections to be set when querying sources in a localization. Defaults to True. |
| listName | string Get only sources saved to the querying user's list, e.g., "favorites". |
| group_ids | list If provided, filter only sources saved to one of these group IDs. |
| includeColorMagnitude | boolean Boolean indicating whether to include the color-magnitude data from Gaia. This will only include data for objects that have an annotation with the appropriate format: an annotation that contains a dictionary with keys named Mag_G, Mag_Bp, Mag_Rp, and Plx (underscores and case are ignored when matching all the above keys). The result is saved in a field named 'color_magnitude'. If no data is available, returns an empty array. Defaults to false (do not search for nor include this info). |
| includeRequested | boolean Boolean indicating whether to include requested saves. Defaults to false. |
| pendingOnly | boolean Boolean indicating whether to only include requested/pending saves. Defaults to false. |
| savedBefore | string Only return sources that were saved before this UTC datetime. |
| savedAfter | string Only return sources that were saved after this UTC datetime. |
| hasSpectrumAfter | string Only return sources with a spectrum saved after this UTC datetime |
| hasSpectrumBefore | string Only return sources with a spectrum saved before this UTC datetime |
| saveSummary | boolean Boolean indicating whether to only return the source save
information in the response (defaults to false). If true,
the response will contain a list of dicts with the following
schema under
|
| sortBy | string The field to sort by. Currently allowed options are ["id", "ra", "dec", "redshift", "saved_at"] |
| sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
| includeComments | boolean Boolean indicating whether to include comment metadata in response. Defaults to false. |
| includePhotometryExists | boolean Boolean indicating whether to return if a source has any photometry points. Defaults to false. |
| includeSpectrumExists | boolean Boolean indicating whether to return if a source has a spectra. Defaults to false. |
| includeLabellers | boolean Boolean indicating whether to return list of users who have labelled this source. Defaults to false. |
| includeHosts | boolean Boolean indicating whether to return source host galaxies. Defaults to false. |
| includeCommentExists | boolean Boolean indicating whether to return if a source has a comment. Defaults to false. |
| removeNested | boolean Boolean indicating whether to remove nested output. Defaults to false. |
| includeThumbnails | boolean Boolean indicating whether to include associated thumbnails. Defaults to false. |
| includeDetectionStats | boolean Boolean indicating whether to include photometry detection statistics for each source (last detection and peak detection). Defaults to false. |
| classifications | Array of strings Comma-separated string of "taxonomy: classification" pair(s) to filter for sources matching that/those classification(s), i.e. "Sitewide Taxonomy: Type II, Sitewide Taxonomy: AGN" |
| classifications_simul | boolean Boolean indicating whether object must satisfy all classifications if query (i.e. an AND rather than an OR). Defaults to false. |
| nonclassifications | Array of strings Comma-separated string of "taxonomy: classification" pair(s) to filter for sources NOT matching that/those classification(s), i.e. "Sitewide Taxonomy: Type II, Sitewide Taxonomy: AGN" |
| unclassified | boolean Boolean indicating whether to reject any sources with classifications. Defaults to false. |
| annotationsFilter | Array of strings Comma-separated string of "annotation: value: operator" triplet(s) to filter for sources matching that/those annotation(s), i.e. "redshift: 0.5: lt" |
| annotationsFilterOrigin | string Comma separated string of origins. Only annotations from these origins are used when filtering with the annotationsFilter. |
| annotationsFilterBefore | string Only return sources that have annotations before this UTC datetime. |
| annotationsFilterAfter | string Only return sources that have annotations after this UTC datetime. |
| commentsFilter | Array of strings Comma-separated string of comment text to filter for sources matching. |
| commentsFilterAuthor | string Comma separated string of authors. Only comments from these authors are used when filtering with the commentsFilter. |
| commentsFilterBefore | string Only return sources that have comments before this UTC datetime. |
| commentsFilterAfter | string Only return sources that have comments after this UTC datetime. |
| minRedshift | number If provided, return only sources with a redshift of at least this value |
| maxRedshift | number If provided, return only sources with a redshift of at most this value |
| minPeakMagnitude | number If provided, return only sources with a peak photometry magnitude of at least this value |
| maxPeakMagnitude | number If provided, return only sources with a peak photometry magnitude of at most this value |
| minLatestMagnitude | number If provided, return only sources whose latest photometry magnitude is at least this value |
| maxLatestMagnitude | number If provided, return only sources whose latest photometry magnitude is at most this value |
| numberDetections | number If provided, return only sources who have at least numberDetections detections. |
| hasSpectrum | boolean If true, return only those matches with at least one associated spectrum |
| hasFollowupRequest | boolean If true, return only those matches with at least one associated followup request |
| followupRequestStatus | string If provided, string to match status of followup_request against |
| createdOrModifiedAfter | string Arrow-parseable date-time string (e.g. 2020-01-01 or 2020-01-01T00:00:00 or 2020-01-01T00:00:00+00:00). If provided, filter by created_at or modified > createdOrModifiedAfter |
| localizationDateobs | string Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include sources |
| localizationRejectSources | bool Remove sources rejected in localization. Defaults to false. |
| spatialCatalogName | string Name of spatial catalog to use. spatialCatalogEntryName must also be defined for use. |
| spatialCatalogEntryName | string Name of spatial catalog entry to use. spatialCatalogName must also be defined for use. |
| includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
| useCache | boolean Boolean indicating whether to use cached results. Defaults to false. |
| queryID | string String to identify query. If provided, will be used to recover previous cached results and speed up query. Defaults to None. |
{- "status": "success",
- "message": "string",
- "data": {
- "sources": [
- {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}Add a new source
| host | any or null The Galaxy associated with this source. |
| comments | Array of any |
| reminders | Array of any |
| comments_on_spectra | Array of any |
| reminders_on_spectra | Array of any |
| annotations | Array of any |
| annotations_on_spectra | Array of any |
| annotations_on_photometry | Array of any |
| classifications | Array of any |
| photometry | Array of any |
| photstats | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| thumbnails | Array of any |
| followup_requests | Array of any |
| assignments | Array of any |
| obj_notifications | Array of any |
| obj_analyses | Array of any |
| sources_in_gcns | Array of any |
| tns_submissions | Array of any |
| id required | string Name of the object. |
| ra_dis | number or null J2000 Right Ascension at discovery time [deg]. |
| dec_dis | number or null J2000 Declination at discovery time [deg]. |
| ra_err | number or null Error on J2000 Right Ascension at discovery time [deg]. |
| dec_err | number or null Error on J2000 Declination at discovery time [deg]. |
| offset | number or null Offset from nearest static object [arcsec]. |
| redshift | number or null Redshift. |
| redshift_error | number or null Redshift error. |
| redshift_origin | string or null Redshift source. |
| host_id | integer or null The ID of the Galaxy to which this Obj is associated. |
| summary | string or null Summary of the obj. |
| summary_history | any or null Record of the summaries generated and written about this obj |
| altdata | any or null Misc. alternative metadata stored in JSON format, e.g. |
| dist_nearest_source | number or null Distance to the nearest Obj [arcsec]. |
| mag_nearest_source | number or null Magnitude of the nearest Obj [AB]. |
| e_mag_nearest_source | number or null Error on magnitude of the nearest Obj [mag]. |
| transient | boolean or null Boolean indicating whether the object is an astrophysical transient. |
| varstar | boolean or null Boolean indicating whether the object is a variable star. |
| is_roid | boolean or null Boolean indicating whether the object is a moving object. |
| mpc_name | string or null Minor planet center name. |
| gcn_crossmatch | any or null List of GCN event dateobs for crossmatched events. |
| tns_name | string or null Transient Name Server name. |
| tns_info | any or null TNS info in JSON format |
| score | number or null Machine learning score. |
| origin | string or null Origin of the object. |
| alias | any or null Alternative names for this object. |
| healpix | integer or null |
| detect_photometry_count | integer or null How many times the object was detected above :math: |
| ra | number or null |
| dec | number or null |
| candidates | Array of any |
| sources | Array of any |
| users | Array of any |
| group_ids | Array of integers List of associated group IDs. If not specified, all of the user or token's groups will be used. |
| refresh_source | bool Refresh source upon post. Defaults to True. |
{- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "healpix": 0,
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
], - "group_ids": [
- 0
], - "refresh_source": null
}{- "status": "success",
- "message": "string",
- "data": {
- "id": "string"
}
}Save or request group(s) to save source, and optionally unsave from group(s).
| objId required | string ID of the object in question. |
| inviteGroupIds required | Array of integers List of group IDs to save or invite to save specified source. |
| unsaveGroupIds | Array of integers List of group IDs from which specified source is to be unsaved. |
{- "objId": "string",
- "inviteGroupIds": [
- 0
], - "unsaveGroupIds": [
- 0
]
}{- "status": "success",
- "message": "string"
}Update a Source table row
| obj_id required | integer |
| groupID required | integer |
| active required | boolean |
| requested required | boolean |
{- "groupID": 0,
- "active": true,
- "requested": true
}{- "status": "success",
- "message": "string"
}Retrieve all comments associated with specified resource
| associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
]
}Retrieve all comments associated with specified resource
| associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
]
}Retrieve a comment
| associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
| comment_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
}Retrieve all comments associated with specified resource
| associated_resource_type required | string Value: "sources" What underlying data the comment is on, e.g., "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum, gcn_event, earthquake, or shift. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
]
}Retrieve a comment
| associated_resource_type required | string What underlying data the comment is on: "sources" or "spectra" or "gcn_event" or "earthquake" or "shift". |
| resource_id required | string Enum: "sources" "spectra" "gcn_event" The ID of the source, spectrum, gcn_event, earthquake, or shift that the comment is posted to. This would be a string for a source ID or an integer for a spectrum, gcn_event, earthquake, or shift. |
| comment_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "author": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "attachment_name": "string",
- "_attachment_path": "string",
- "origin": "string",
- "bot": true,
- "attachment_bytes": "string",
- "author_id": 0
}
}Get a summary of all the activity of shift users on skyportal for a given period
| shift_id required | integer |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}Retrieve shifts
| shift_id required | integer |
| group_id | integer |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "group": null,
- "users": [
- null
], - "shift_users": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "name": "string",
- "description": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "required_users_number": 0,
- "id": 0,
- "shift_users_ids": null
}
]
}Update a shift
| shift_id required | integer |
| group | any or null The Shift's Group. |
| users | Array of any |
| shift_users | Array of any |
| comments | Array of any |
| reminders | Array of any |
| name | string or null Name of the shift. |
| description | string or null Longer description of the shift. |
| start_date required | string <date-time> The start time of this shift. |
| end_date required | string <date-time> The end time of this shift. |
| group_id required | integer ID of the Shift's Group. |
| required_users_number | integer or null The number of users required to join this shift for it to be considered full |
{- "group": null,
- "users": [
- null
], - "shift_users": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "name": "string",
- "description": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "required_users_number": 0
}{- "status": "success",
- "message": "string"
}Add a new shift
| group | any or null The Shift's Group. |
| users | Array of any |
| shift_users | Array of any |
| comments | Array of any |
| reminders | Array of any |
| name | string or null Name of the shift. |
| description | string or null Longer description of the shift. |
| start_date required | string <date-time> The start time of this shift. |
| end_date required | string <date-time> The end time of this shift. |
| group_id required | integer ID of the Shift's Group. |
| required_users_number | integer or null The number of users required to join this shift for it to be considered full |
| shift_admins | Array of integers List of IDs of users to be shift admins. Current user will automatically be added as a shift admin. |
{- "group": null,
- "users": [
- null
], - "shift_users": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "name": "string",
- "description": "string",
- "start_date": "2019-08-24T14:15:22Z",
- "end_date": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "required_users_number": 0,
- "shift_admins": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0,
- "name": "string",
- "start_date": "string",
- "end_date": "string",
- "shift_admins": [ ],
- "description": "string",
- "required_users_number": 0
}
}Add a shift user
| shift_id required | integer |
| userID required | integer |
| admin required | boolean |
{- "userID": 0,
- "admin": true
}{- "status": "success",
- "message": "string",
- "data": {
- "shift_id": 0,
- "user_id": 0,
- "admin": true,
- "needs_replacement": true
}
}Update a shift user's admin status, or needs_replacement status
| shift_id required | integer |
| userID required | integer |
| admin | boolean Boolean indicating whether user is shift admin. |
| needs_replacement | boolean Boolean indicating whether user needs replacement or not |
{- "userID": 0,
- "admin": true,
- "needs_replacement": true
}{- "status": "success",
- "message": "string"
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}Update an annotation
| associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum. |
| annotation_id required | integer |
| author | any or null Annotation's author. |
| obj | any or null The Annotation's Obj. |
| groups | Array of any |
| data required | any Searchable data in JSON format |
| origin required | string What generated the annotation. This should generally map to a filter/group name. But since an annotation can be made accessible to multiple groups, the origin name does not necessarily have to map to a single group name. The important thing is to make the origin distinct and descriptive such that annotations from the same origin generally have the same metrics. One annotation with multiple fields from each origin is allowed. |
| author_id required | integer ID of the Annotation author's User instance. |
| obj_id required | string ID of the Annotation's Obj. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the annotation. |
{- "author": null,
- "obj": null,
- "groups": [
- null
], - "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string",
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Post an annotation
| associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for an object ID, or an integer for other data types, e.g., a spectrum. |
| origin required | string String describing the source of this information. Only one Annotation per origin is allowed, although each Annotation can have multiple fields. To add/change data, use the update method instead of trying to post another Annotation from this origin. Origin must be a non-empty string starting with an alphanumeric character or underscore. (it must match the regex: /^\w+/) |
| data required | object |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view annotation. Defaults to all of requesting user's groups. |
{- "origin": "string",
- "data": { },
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "annotation_id": 0
}
}Delete an annotation
| associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for a spectrum. |
| annotation_id required | integer |
{- "status": "success",
- "message": "string"
}Retrieve an annotation
| associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
| annotation_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
}Update an annotation
| associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum. |
| annotation_id required | integer |
| author | any or null Annotation's author. |
| obj | any or null The Annotation's Obj. |
| groups | Array of any |
| data required | any Searchable data in JSON format |
| origin required | string What generated the annotation. This should generally map to a filter/group name. But since an annotation can be made accessible to multiple groups, the origin name does not necessarily have to map to a single group name. The important thing is to make the origin distinct and descriptive such that annotations from the same origin generally have the same metrics. One annotation with multiple fields from each origin is allowed. |
| author_id required | integer ID of the Annotation author's User instance. |
| obj_id required | string ID of the Annotation's Obj. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the annotation. |
{- "author": null,
- "obj": null,
- "groups": [
- null
], - "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string",
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Delete an annotation
| associated_resource_type required | string What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for a spectrum. |
| annotation_id required | integer |
{- "status": "success",
- "message": "string"
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}retrieve the PhotStat associated with the obj_id.
| obj_id required | string object ID to get statistics on |
{- "obj": null,
- "last_update": "2019-08-24T14:15:22Z",
- "last_full_update": "2019-08-24T14:15:22Z",
- "obj_id": "string",
- "num_obs_global": 0,
- "num_obs_per_filter": null,
- "num_det_global": 0,
- "num_det_no_forced_phot_global": 0,
- "num_det_per_filter": null,
- "first_detected_mjd": 0,
- "first_detected_mag": 0,
- "first_detected_filter": "string",
- "last_detected_mjd": 0,
- "last_detected_mag": 0,
- "last_detected_filter": "string",
- "first_detected_no_forced_phot_mjd": 0,
- "first_detected_no_forced_phot_mag": 0,
- "first_detected_no_forced_phot_filter": "string",
- "last_detected_no_forced_phot_mjd": 0,
- "last_detected_no_forced_phot_mag": 0,
- "last_detected_no_forced_phot_filter": "string",
- "recent_obs_mjd": 0,
- "predetection_mjds": null,
- "last_non_detection_mjd": 0,
- "time_to_non_detection": 0,
- "mean_mag_global": 0,
- "mean_mag_per_filter": null,
- "mean_color": null,
- "peak_mjd_global": 0,
- "peak_mjd_per_filter": null,
- "peak_mag_global": 0,
- "peak_mag_per_filter": null,
- "faintest_mag_global": 0,
- "faintest_mag_per_filter": null,
- "deepest_limit_global": 0,
- "deepest_limit_per_filter": null,
- "rise_rate": 0,
- "decay_rate": 0,
- "mag_rms_global": 0,
- "mag_rms_per_filter": null,
- "id": 0
}find the number of sources with and without a PhotStat object
| createdAtStartTime | string arrow parseable string, only objects that have been created after this time will be checked for missing/existing PhotStats. |
| createdAtEndTime | string arrow parseable string, only objects that have been created before this time will be checked for missing/existing PhotStats. |
| quickUpdateStartTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) after this time will be recalculated. |
| quickUpdateEndTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) before this time will be recalculated. |
| fullUpdateStartTime | string arrow parseable string, any object's PhotStat that has been fully updated after this time will be counted. |
| fullUpdateEndTime | string arrow parseable string, any object's PhotStat that has been fully updated before this time will be counted. |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}calculate photometric stats for a batch of sources without a PhotStat
| numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
| pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
| createdAtStartTime | string arrow parseable string, only objects that have been created after this time will be checked for missing PhotStats. |
| createdAtEndTime | string arrow parseable string, only objects that have been created before this time will be checked for missing PhotStats. |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}manually recalculate the photometric stats for a batch of sources
| numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
| pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
| createdAtStartTime | string arrow parseable string, only objects that have been created after this time will be checked for missing/existing PhotStats. |
| createdAtEndTime | string arrow parseable string, only objects that have been created before this time will be checked for missing/existing PhotStats. |
| quickUpdateStartTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) after this time will be recalculated. |
| quickUpdateEndTime | string arrow parseable string, any object's PhotStat that has been updated (either full update or an update at insert time) before this time will be recalculated. |
| fullUpdateStartTime | string arrow parseable string, any object's PhotStat that has been fully updated after this time will be recalculated. |
| fullUpdateEndTime | string arrow parseable string, any object's PhotStat that has been fully updated before this time will be recalculated. |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}Retrieve photometry
| photometry_id required | integer |
| format | string Enum: "mag" "flux" Return the photometry in flux or magnitude space? If a value for this query parameter is not provided, the result will be returned in magnitude space. |
| magsys | string Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude or zeropoint system of the output. (Default AB) |
{- "status": "success",
- "message": "string",
- "data": {
- "ref_zp": null,
- "alert_id": null,
- "instrument_id": 0,
- "magsys": "jla1",
- "dec": null,
- "dec_unc": null,
- "ref_fluxerr": null,
- "origin": null,
- "fluxerr": 0,
- "filter": "bessellux",
- "obj_id": "string",
- "flux": null,
- "altdata": null,
- "zp": 0,
- "assignment_id": null,
- "ref_flux": null,
- "mjd": 0,
- "ra_unc": null,
- "ra": null
}
}Update photometry
| photometry_id required | integer |
| altdata | object or null Default: null Misc. alternative metadata stored in JSON format, e.g. |
| limiting_mag required | number Limiting magnitude of the image in the magnitude system |
| magref | any or null Default: null Magnitude of the reference image. in the magnitude system |
| magerr | number or null Default: null Magnitude error of the observation in the magnitude system |
| origin | any or null Default: null Provenance of the Photometry. If a record is already present with identical origin, only the groups or streams list will be updated (other data assumed identical). Defaults to None. |
| alert_id | integer or null Default: null Corresponding alert ID. If a record is already present with identical alert ID, only the groups list will be updated (other alert data assumed identical). Defaults to None. |
| mjd required | number MJD of the observation. |
| instrument_id required | integer ID of the instrument with which the observation was carried out. |
| ra_unc | number or null Default: null Uncertainty on RA [arcsec]. |
| magsys required | any Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude system to which the flux and the zeropoint are tied. |
| filter required | any Enum: "bessellux" "bessellb" "bessellv" "bessellr" "besselli" "standard::u" "standard::b" "standard::v" "standard::r" "standard::i" "desu" "desg" "desr" "desi" "desz" "desy" "sdssu" "sdssg" "sdssr" "sdssi" "sdssz" "f435w" "f475w" "f555w" "f606w" "f625w" "f775w" "f850lp" "nicf110w" "nicf160w" "f098m" "f105w" "f110w" "f125w" "f127m" "f139m" "f140w" "f153m" "f160w" "f218w" "f225w" "f275w" "f300x" "f336w" "f350lp" "f390w" "f689m" "f763m" "f845m" "f438w" "uvf475w" "uvf555w" "uvf606w" "uvf625w" "uvf775w" "uvf814w" "uvf850lp" "kepler" "cspb" "csphs" "csphd" "cspjs" "cspjd" "cspv3009" "cspv3014" "cspv9844" "cspys" "cspyd" "cspg" "cspi" "cspk" "cspr" "cspu" "f070w" "f090w" "f115w" "f150w" "f200w" "f277w" "f356w" "f444w" "f140m" "f162m" "f182m" "f210m" "f250m" "f300m" "f335m" "f360m" "f410m" "f430m" "f460m" "f480m" "f560w" "f770w" "f1000w" "f1130w" "f1280w" "f1500w" "f1800w" "f2100w" "f2550w" "f1065c" "f1140c" "f1550c" "f2300c" "lsstu" "lsstg" "lsstr" "lssti" "lsstz" "lssty" "keplercam::us" "keplercam::b" "keplercam::v" "keplercam::r" "keplercam::i" "4shooter2::us" "4shooter2::b" "4shooter2::v" "4shooter2::r" "4shooter2::i" "f062" "f087" "f106" "f129" "f158" "f184" "f213" "f146" "ztfg" "ztfr" "ztfi" "uvot::b" "uvot::u" "uvot::uvm2" "uvot::uvw1" "uvot::uvw2" "uvot::v" "uvot::white" "ps1::open" "ps1::g" "ps1::r" "ps1::i" "ps1::z" "ps1::y" "ps1::w" "atlasc" "atlaso" "2massj" "2massh" "2massks" "gaia::gbp" "gaia::g" "gaia::grp" "gaia::grvs" "tess" "gotob" "gotog" "gotol" "gotor" "swiftxrt" "nicerxti" The bandpass of the observation. |
| mag | number or null Default: null Magnitude of the observation in the magnitude system |
| obj_id required | string ID of the Object to which the photometry will be attached. |
| assignment_id | integer or null Default: null ID of the classical assignment which generated the photometry |
| dec | number or null Default: null ICRS Declination of the centroid of the photometric aperture [deg]. |
| dec_unc | number or null Default: null Uncertainty on dec [arcsec]. |
| ra | number or null Default: null ICRS Right Ascension of the centroid of the photometric aperture [deg]. |
| e_magref | any or null Default: null Gaussian error on the reference magnitude. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
{- "altdata": null,
- "limiting_mag": 0,
- "magref": null,
- "magerr": null,
- "origin": null,
- "alert_id": null,
- "mjd": 0,
- "instrument_id": 0,
- "ra_unc": null,
- "magsys": "jla1",
- "filter": "bessellux",
- "mag": null,
- "obj_id": "string",
- "assignment_id": null,
- "dec": null,
- "dec_unc": null,
- "ra": null,
- "e_magref": null
}{- "status": "success",
- "message": "string"
}Update and/or upload photometry, resolving potential duplicates
| refresh required | boolean If true, triggers a refresh of the object's photometry on the web page, only for the users that have the object's source page open. |
| duplicate_ignore_flux required | boolean If true, will not use the flux/fluxerr of existing rows when looking for duplicates but only mjd, instrument_id, filter, and origin. Reserved to super admin users only, to avoid misuse and permanent data loss. |
| overwrite_flux required | boolean If true and duplicate_ignore_flux is also true, will update the flux/fluxerr of existing rows (duplicates) with the new values. Applies only to rows with an origin already specified. If existing duplicates have no origin, the update will be skipped. |
| magref | any or null Default: null Magnitude of the reference image. in the magnitude system |
| instrument_id required | any ID of the |
| magsys required | any The magnitude system to which the magnitude, magnitude error, and limiting magnitude are tied. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values not allowed. Allowed values: |
| dec | any or null Default: null ICRS Declination of the centroid of the photometric aperture [deg]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
| dec_unc | any or null Default: null Uncertainty on dec [arcsec]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
| e_magref | any or null Default: null Gaussian error on the reference magnitude. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
| origin | any or null Default: null Provenance of the Photometry. If a record is already present with identical origin, only the groups or streams list will be updated (other data assumed identical). Defaults to None. |
| filter required | any The bandpass of the observation(s). Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values not allowed. Allowed values: |
| mag | any or null Default: null Magnitude of the observation in the magnitude system |
| obj_id required | any ID of the |
| group_ids | any Default: [] List of group IDs to which photometry points will be visible. If 'all', will be shared with site-wide public group (visible to all users who can view associated source). |
| altdata | any or null Default: null Misc. alternative metadata stored in JSON format, e.g. |
| limiting_mag required | any Limiting magnitude of the image in the magnitude system |
| magerr | any or null Default: null Error on the magnitude in the magnitude system |
| assignment_id | integer or null Default: null ID of the classical assignment which generated the photometry |
| mjd required | any MJD of the observation(s). Can be a given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values not allowed. |
| ra_unc | any or null Default: null Uncertainty on RA [arcsec]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
| limiting_mag_nsigma | any Default: 3 Number of standard deviations above the background that the limiting magnitudes correspond to. Null values not allowed. Default = 3.0. |
| stream_ids | any Default: [] List of stream IDs to which photometry points will be visible. |
| ra | any or null Default: null ICRS Right Ascension of the centroid of the photometric aperture [deg]. Can be given as a scalar or a 1D list. If a scalar, will be broadcast to all values given as lists. Null values allowed. |
{- "magref": null,
- "instrument_id": null,
- "magsys": null,
- "dec": null,
- "dec_unc": null,
- "e_magref": null,
- "origin": null,
- "filter": null,
- "mag": null,
- "obj_id": null,
- "group_ids": [ ],
- "altdata": null,
- "limiting_mag": null,
- "magerr": null,
- "assignment_id": null,
- "mjd": null,
- "ra_unc": null,
- "limiting_mag_nsigma": 3,
- "stream_ids": [ ],
- "ra": null
}{- "status": "success",
- "message": "string",
- "data": {
- "ids": [
- 0
], - "upload_id": "string"
}
}Retrieve a photometric series
| photometric_series_id required | integer |
| dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}
}Retrieve all photometric series, based on various cuts.
| dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
| ra | number RA for spatial filtering (in decimal degrees) |
| dec | number Declination for spatial filtering (in decimal degrees) |
| radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
| objectID | string Portion of ID to filter on |
| rejectedObjectIDs | str Comma-separated string of object IDs not to be returned, useful in cases where you are looking for new objects passing a query. |
| seriesName | string Get series that match this name. The match must be exact. This is useful when getting photometry for multiple objects taken at the same time (e.g., for calibrating against each other). The series name can be, e.g., a TESS sector, or a date/field name identifier. Generally a series name is shared only by data taken over that same time period. |
| seriesObjID | string Get only photometry for the objects named by this object id. This is the internal naming used inside each photometric series, i.e., the index used for each source in the images that were used to create the photometric series. Not the same as the SkyPortal object ID. E.g., this could be a TESS TIC ID, or some internal numbering used in the specific field that was observed. |
| filter | string Retrieve only series matching this filter, e.g., "ztfg". |
| channel | string The channel name/id to filter on. |
| origin | string The origin can be anything that gives an idea of the provenance of the photometric series. This can be, e.g., the name of the pipeline that produced the photometry from the images, or the level of calibration, or any other pre-defined string that identifies where the data came from that isn't covered by the other fields (like channel or filter or instrument). |
| filename | string Portion of filename to filter on. If the filename is a relative path, will append the data directory from the config file to the beginning of the filename. (by default that is 'persistentdata/phot_series'). |
| startBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started before this time. |
| startAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started after this time. |
| midTimeBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed before this time. |
| midTimeAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed after this time. |
| endBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended before this time. |
| endAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended after this time. |
| detected | boolean If true, get only series with one or more detections. If false, get only series with no detections. If left out, do not filter at all on detection status. |
| expTime | number Get only series with this exact exposure time (seconds). |
| minExpTime | number Get only series with an exposure time above/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
| maxExpTime | number Get only series with an exposure time under/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
| minFrameRate | number Get only series with a frame rate higher/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
| maxFrameRate | number Get only series with a frame rate lower/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
| minNumExposures | number Get only series with this many exposures, or more. |
| maxNumExposures | number Get only series with this many exposures, or less. |
| instrumentID | number get only series taken with this instrument. |
| followupRequestID | number get only series taken with this followup request. |
| assignmentID | number get only series taken with this assignment. |
| ownerID | number get only series uploaded by this user. |
| magBrighterThan | number get only series with mean_mag brighter or equal to this value. |
| magFainterThan | number get only series with mean_mag fainter or equal to this value. |
| limitingMagBrighterThan | number Retrieve only series with limiting mags brighter or equal to this value. |
| limitingMagFainterThan | number Retrieve only series with limiting mags fainter or equal to this value. |
| limitingMagIsNone | boolean Retrieve only series that do not have limiting mag. |
| magrefBrighterThan | number Get only series that have a magref, and that the magref is brighter or equal to this value. |
| magrefFainterThan | number Get only series that have a magref, and that the magref is fainter or equal to this value. |
| maxRMS | number get only series with rms_mag less than this. |
| minRMS | number get only series with rms_mag more than this. |
| useRobustMagAndRMS | boolean If true, will use the robust_mag and robust_rms values instead of mean_mag and rms_mag when filtering on mean magnitude or RMS. Does not affect the magref query. |
| maxMedianSNR | number Get only series where the median S/N is less than this. The S/N is calculated using the robust RMS. |
| minMedianSNR | number Get only series where the median S/N is more than this. The S/N is calculated using the robust RMS. |
| maxBestSNR | number Get only series where the maximum S/N is less than this. The S/N is calculated using the robust RMS. |
| minBestSNR | number Get only series where the maximum S/N is more than this. The S/N is calculated using the robust RMS. |
| maxWorstSNR | number Get only series where the lowest S/N is less than this. The S/N is calculated using the robust RMS. |
| minWorstSNR | number Get only series where the lowest S/N is more than this. The S/N is calculated using the robust RMS. |
| hash | string Get only a series that matches this file hash. This is useful if you have an HDF5 file downloaded from the SkyPortal backend, and want to associate it with a PhotometrySeries object. We use an MD5 hash of the file contents. |
| sortBy | string The field to sort by. Currently allowed options are ["id", "ra", "dec", "redshift", "saved_at"] |
| sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
| numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "series": [
- {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}Get photometry taken by specific instruments over a date range
| format | string Enum: "mag" "flux" Return the photometry in flux or magnitude space? If a value for this query parameter is not provided, the result will be returned in magnitude space. |
| magsys | string Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude or zeropoint system of the output. (Default AB) |
| max_date | string or null <date-time> Default: null Query for photometry taken before this UT |
| instrument_ids | Array of integers or null Default: null IDs of the instruments to query for photometry from. If |
| min_date | string or null <date-time> Default: null Query for photometry taken after this UT |
{- "max_date": null,
- "instrument_ids": null,
- "min_date": null
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "ref_zp": null,
- "alert_id": null,
- "instrument_id": 0,
- "magsys": "jla1",
- "dec": null,
- "dec_unc": null,
- "ref_fluxerr": null,
- "origin": null,
- "fluxerr": 0,
- "filter": "bessellux",
- "obj_id": "string",
- "flux": null,
- "altdata": null,
- "zp": 0,
- "assignment_id": null,
- "ref_flux": null,
- "mjd": 0,
- "ra_unc": null,
- "ra": null
}
]
}Copy all photometry points from one source to another
| target_id required | string The obj_id of the target Source (to which the photometry is being copied to) |
| group_ids required | Array of integers List of IDs of groups to give photometry access to |
| origin_id required | string The ID of the Source's Obj the photometry is being copied from |
{- "group_ids": [
- 0
], - "origin_id": "string"
}{- "status": "success",
- "message": "string"
}Retrieve all photometry associated with an Object
| obj_id required | string ID of the object to retrieve photometry for |
| format | string Enum: "mag" "flux" Return the photometry in flux or magnitude space? If a value for this query parameter is not provided, the result will be returned in magnitude space. |
| magsys | string Enum: "jla1" "ab" "vega" "bd17" "csp" "ab-b12" The magnitude or zeropoint system of the output. (Default AB) |
| individualOrSeries | string Enum: "individual" "series" "both" Whether to return individual photometry points, photometric series, or both (Default). |
| phaseFoldData | boolean Boolean indicating whether to phase fold the light curve. Defaults to false. |
| deduplicatePhotometry | boolean Boolean indicating whether to deduplicate photometry. Defaults to false. |
| includeOwnerInfo | boolean Boolean indicating whether to include photometry owner. Defaults to false. |
| includeStreamInfo | boolean Boolean indicating whether to include photometry stream information. Defaults to false. |
| includeValidationInfo | boolean Boolean indicating whether to include photometry validation information. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "ref_zp": null,
- "alert_id": null,
- "instrument_id": 0,
- "magsys": "jla1",
- "dec": null,
- "dec_unc": null,
- "ref_fluxerr": null,
- "origin": null,
- "fluxerr": 0,
- "filter": "bessellux",
- "obj_id": "string",
- "flux": null,
- "altdata": null,
- "zp": 0,
- "assignment_id": null,
- "ref_flux": null,
- "mjd": 0,
- "ra_unc": null,
- "ra": null
}
]
}Retrieve all annotations associated with specified resource
| associated_resource_type required | string Enum: "sources" "spectra" What underlying data the annotation is on: must be one of either "sources" or "spectra". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
]
}Retrieve an annotation
| associated_resource_type required | string Enum: "sources" "spectra" "photometry" What underlying data the annotation is on: must be one of "sources", "spectra", or "photometry." |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectra. |
| annotation_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "author": null,
- "obj": null,
- "groups": [
- null
], - "id": 0,
- "data": null,
- "origin": "string",
- "author_id": 0,
- "obj_id": "string"
}
}Get observation plan requests of the GcnEvent.
| gcnevent_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
]
}Get survey efficiency analyses of the GcnEvent.
| gcnevent_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "gcnevent": null,
- "localization": null,
- "instrument": null,
- "requester": null,
- "groups": [
- null
], - "gcnevent_id": 0,
- "localization_id": 0,
- "instrument_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
]
}Get catalog queries of the GcnEvent.
| gcnevent_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "requester": null,
- "allocation": null,
- "target_groups": [
- null
], - "requester_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "id": 0
}
]
}Post a GCN Event alias
| dateobs required | string The dateobs of the event, as an arrow parseable string |
| alias required | string Alias to add to the event |
{- "alias": "string"
}{- "status": "success",
- "message": "string"
}Delete a GCN event alias
| dateobs required | dateobs |
| alias required | string Alias to remove from the event |
{- "alias": "string"
}{- "status": "success",
- "message": "string"
}Ingest GCN xml file
| dateobs | any UTC event timestamp |
| json | string JSON notice content. |
| xml | string VOEvent XML content. |
{- "dateobs": null,
- "json": "string",
- "xml": "string"
}{- "status": "success",
- "message": "string"
}Retrieve a reminder
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" "earthquake" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake" |
| resource_id required | string The ID of the source, spectrum, gcn_event or shift that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event |
| reminder_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
}Post a reminder
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift". |
| resource_id required | string The ID of the source or spectrum that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum. |
| text required | string |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view reminder. Defaults to all of requesting user's groups. |
{- "text": "string",
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "reminder_id": 0
}
}Delete a reminder
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift". |
| resource_id required | string The ID of the source or spectrum that the reminder is posted to. This would be a string for a source ID or an integer for a spectrum or gcn_event. |
| reminder_id required | integer |
{- "status": "success",
- "message": "string"
}Update a reminder
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift". |
| resource_id required | string The ID of the source or spectrum that the reminder is posted to. This would be a string for an object ID or an integer for a spectrum, gcn_event or shift. |
| reminder_id required | integer |
| obj | any or null The Reminder's Obj. |
| user | any or null Reminder's user. |
| groups | Array of any |
| obj_id required | string ID of the Reminder's Obj. |
| text required | string Reminder body. |
| origin | string or null Reminder origin. |
| bot | boolean Boolean indicating whether reminder was posted via a bot (token-based request). |
| next_reminder required | string <date-time> Next reminder. |
| reminder_delay required | number Delay until next reminder in days. |
| number_of_reminders required | integer Number of remaining requests. |
| user_id required | integer ID of the Reminder User instance. |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view reminder. |
{- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0,
- "group_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Retrieve all reminders associated with specified resource
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}Retrieve all reminders associated with specified resource
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}Scrape aliases of a GCN Event from GCNs notice/circulars
| dateobs required | string The dateobs of the event, as an arrow parseable string |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Retrieve all reminders associated with specified resource
| associated_resource_type required | string Enum: "source" "spectra" "gcn_event" "shift" What underlying data the reminder is on: "sources" or "spectra" or "gcn_event" or "shift" or "earthquake". |
| resource_id required | string The ID of the underlying data. This would be a string for a source ID or an integer for other data types like spectrum or gcn_event. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "obj": null,
- "user": null,
- "groups": [
- null
], - "obj_id": "string",
- "id": 0,
- "text": "string",
- "origin": "string",
- "bot": true,
- "next_reminder": "2019-08-24T14:15:22Z",
- "reminder_delay": 0,
- "number_of_reminders": 0,
- "user_id": 0
}
]
}Ingest EarthquakeEvent
| sent_by | any or null The user that saved this EarthquakeEvent |
| notices | Array of any |
| predictions | Array of any |
| measurements | Array of any |
| comments | Array of any |
| reminders | Array of any |
| sent_by_id required | integer The ID of the User who created this GcnTag. |
| event_id required | string |
| event_uri | string or null |
| status | string The status of the earthquake event. |
{- "sent_by": null,
- "notices": [
- null
], - "predictions": [
- null
], - "measurements": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "sent_by_id": 0,
- "event_id": "string",
- "event_uri": "string",
- "status": "string"
}{- "status": "success",
- "message": "string"
}Retrieve a GCN report
| dateobs required | string |
| summary_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "sent_by": null,
- "group": null,
- "sent_by_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "data": null,
- "report_name": "string",
- "published": true,
- "id": 0
}
}Retrieve a GCN summary
| dateobs required | string |
| summary_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "sent_by": null,
- "group": null,
- "sent_by_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "group_id": 0,
- "title": "string",
- "text": "string",
- "id": 0
}
}Get a summary of all the activity of shift users on skyportal for a given period
| shift_id required | integer |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}Compute instrument field probabilities for a skymap
| dateobs required | string |
| Instrument ID required | integer |
| localization_name required | string Localization map name |
| integrated_probability | float Cumulative integrated probability threshold |
{- "status": "success",
- "message": "string"
}Ingest GCN xml file
| dateobs | any UTC event timestamp |
| json | string JSON notice content. |
| xml | string VOEvent XML content. |
{- "dateobs": null,
- "json": "string",
- "xml": "string"
}{- "status": "success",
- "message": "string"
}Create a summary plot for the observability for a given event.
| localization_id required | integer ID of localization to generate observability plot for |
| maximumAirmass | number Maximum airmass to consider. Defaults to 2.5. |
| twilight | string Twilight definition. Choices are astronomical (-18 degrees), nautical (-12 degrees), and civil (-6 degrees). |
{- "status": "success",
- "message": "string"
}Create a summary plot for the observability for a given event.
| localization_id required | integer ID of localization to generate map for |
| maximumAirmass | number Maximum airmass to consider. Defaults to 2.5. |
| twilight | string Twilight definition. Choices are astronomical (-18 degrees), nautical (-12 degrees), and civil (-6 degrees). |
{- "status": "success",
- "message": "string"
}Retrieve a GCN localization
| dateobs required | dateobs |
| localization_name required | localization_name |
| include2DMap | boolean Boolean indicating whether to include flatted skymap. Defaults to false. |
{- "contour": null,
- "dateobs": "string",
- "flat_2d": [
- 0
], - "localization_name": "string"
}A fits file corresponding to the intersection of the input fits files.
| dateobs required | dateobs |
| localization_name required | localization_name |
{- "status": "error",
- "message": "string",
- "data": { }
}Post a skymap-based trigger
| integrated_probability | number Integrated probability within skymap. |
| localization_id required | integer Localization ID. |
| allocation_id required | integer Followup request allocation ID. |
{- "integrated_probability": 0,
- "localization_id": 0,
- "allocation_id": 0
}{- "status": "success",
- "message": "string"
}Create a summary plot for the observability for a given source.
| obj_id required | string ID of object to generate observability plot for |
| maximumAirmass | number Maximum airmass to consider. Defaults to 2.5. |
| twilight | string Twilight definition. Choices are astronomical (-18 degrees), nautical (-12 degrees), and civil (-6 degrees). |
{- "status": "success",
- "message": "string"
}Ingest GCN xml file
| dateobs | any UTC event timestamp |
| json | string JSON notice content. |
| xml | string VOEvent XML content. |
{- "dateobs": null,
- "json": "string",
- "xml": "string"
}{- "status": "success",
- "message": "string"
}Post sources that have been confirmed in a GCN to TNS
| dateobs required | string The dateobs of the event, as an arrow parseable string |
| tnsrobotID required | int TNS Robot ID. |
| reporters | string Reporters for the TNS report. |
| archival | boolean Report sources as archival (i.e. no upperlimit). Defaults to False. |
| archivalComment | string Comment on archival source. Required if archival is True. |
| sourcesIDList | string A comma-separated list of source_id's to post. If not provided, all sources confirmed in GCN will be posted. |
| confirmed | boolean Only post sources noted as confirmed / highlighted. Defaults to True. |
{- "tnsrobotID": null,
- "reporters": "string",
- "archival": true,
- "archivalComment": "string",
- "sourcesIDList": "string",
- "confirmed": true
}{- "status": "success",
- "message": "string"
}Retrieve sources that have been confirmed/rejected in a GCN
| dateobs required | string The dateobs of the event, as an arrow parseable string |
| sourcesIDList | string A comma-separated list of source_id's to retrieve. If not provided, all sources confirmed or rejected in GCN will be returned. |
{- "status": "success",
- "message": "string",
- "data": [
- null
]
}Retrieve a source that has been confirmed or rejected in a GCN
| dateobs required | string The dateobs of the event, as an arrow parseable string |
| source_id required | string The source_id of the source to retrieve |
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0,
- "obj_id": "string",
- "dateobs": "string",
- "confirmed": true
}
}Deletes the confirmed or rejected status of source in a GCN. Its status can be considered as 'undefined'.
| dateobs required | string |
| source_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Update the confirmed or rejected status of a source in a GCN
| dateobs required | string |
| source_id required | string |
| confirmed required | boolean Whether the source is confirmed (True) or rejected (False) |
{- "confirmed": true
}{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Retrieve a source that has been confirmed or rejected in a GCN
| dateobs required | string The dateobs of the event, as an arrow parseable string |
| source_id required | string The source_id of the source to retrieve |
{- "status": "success",
- "message": "string",
- "data": {
- "id": 0,
- "obj_id": "string",
- "dateobs": "string",
- "confirmed": true
}
}Confirm or reject a source in a gcn
| dateobs required | string The dateobs of the event, as an arrow parseable string |
| localization_name required | string The name of the localization of the event |
| localization_cumprob required | string The cumprob of the localization of the event |
| source_id required | string The source_id of the source to confirm or reject |
| confirmed required | boolean Whether the source is confirmed (True) or rejected (False) |
| start_date required | string Choose sources with a first detection after start_date, as an arrow parseable string |
| end_date required | string Choose sources with a last detection before end_date, as an arrow parseable string |
{- "localization_name": "string",
- "localization_cumprob": "string",
- "source_id": "string",
- "confirmed": true,
- "start_date": "string",
- "end_date": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Deletes the confirmed or rejected status of source in a GCN. Its status can be considered as 'undefined'.
| dateobs required | string |
| source_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Update the confirmed or rejected status of a source in a GCN
| dateobs required | string |
| source_id required | string |
| confirmed required | boolean Whether the source is confirmed (True) or rejected (False) |
{- "confirmed": true
}{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Get the GCNs associated with a source (GCNs for which the source has been confirmed)
| source_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "gcns": [
- "string"
]
}
}Get an airmass chart for the GcnEvent
| localization_id required | integer ID of localization to generate airmass chart for |
| telescope_id required | integer ID of telescope to generate airmass chart for |
{- "status": "success",
- "message": "string"
}Submit the executed observations to treasuremap.space
| instrument_id required | string ID for the instrument to submit |
| startDate required | string Filter by start date |
| endDate required | string Filter by end date |
| localizationDateobs | string Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
| numberObservations | number Minimum number of observations of a field required to include. Defaults to 1. |
{- "status": "success",
- "message": "string"
}Submit manual observation plan.
| localization_id required | integer Localization ID. |
| target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
| allocation_id required | integer Observation plan request allocation ID. |
| observation_plan_data | any Observation plan data json |
| status | string Default: "pending submission" The status of the request. |
| gcnevent_id required | integer ID of the GcnEvent. |
{- "localization_id": 0,
- "target_group_ids": [
- 0
], - "allocation_id": 0,
- "observation_plan_data": null,
- "status": "pending submission",
- "gcnevent_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Submit observation plan request.
| localization_id required | integer Localization ID. |
| target_group_ids | Array of integers IDs of groups to share the results of the observation plan request with. |
| allocation_id required | integer Observation plan request allocation ID. |
| status | string Default: "pending submission" The status of the request. |
| payload | any Content of the observation plan request. |
| gcnevent_id required | integer ID of the GcnEvent. |
{- "localization_id": 0,
- "target_group_ids": [
- 0
], - "allocation_id": 0,
- "status": "pending submission",
- "payload": null,
- "gcnevent_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Get a GCN-izable summary of the observation plan.
| observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}Submit an observation plan.
| observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}Get a movie summary of the observation plan.
| observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}Perform an efficiency analysis of the observation plan.
| observation_plan_id required | string |
| numberInjections | number Number of simulations to evaluate efficiency with. Defaults to 1000. |
| numberDetections | number Number of detections required for detection. Defaults to 1. |
| detectionThreshold | number Threshold (in sigmas) required for detection. Defaults to 5. |
| minimumPhase | number Minimum phase (in days) post event time to consider detections. Defaults to 0. |
| maximumPhase | number Maximum phase (in days) post event time to consider detections. Defaults to 3. |
| model_name | string Model to simulate efficiency for. Must be one of kilonova, afterglow, or linear. Defaults to kilonova. |
| optionalInjectionParameters | any |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the analyses. Defaults to all of requesting user's groups. |
{- "status": "success",
- "message": "string"
}Get GeoJSON summary of the observation plan.
| observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}Get survey efficiency analyses of the observation plan.
| observation_plan_id required | string |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
]
}Submit the fields in the observation plan to an observing run
| observation_plan_id required | integer ID of observation plan request to create observing run for |
{- "status": "success",
- "message": "string"
}Delete selected fields from the observation plan.
| observation_plan_id required | string |
| fieldIds | Array of integers List of field IDs to remove from the plan |
{- "fieldIds": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "requester": null,
- "last_modified_by": null,
- "gcnevent": null,
- "localization": null,
- "allocation": null,
- "observation_plans": [
- null
], - "target_groups": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "requester_id": 0,
- "last_modified_by_id": 0,
- "gcnevent_id": 0,
- "localization_id": 0,
- "payload": null,
- "status": "string",
- "allocation_id": 0,
- "combined_id": "string",
- "default_plan": true,
- "id": 0
}
}{- "status": "success",
- "message": "string",
- "data": {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
}Add alert stream access to group
| group_id required | integer |
| stream_id required | integer |
{- "stream_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "stream_id": 0
}
}Add a group user
| group_id required | integer |
| userID required | integer |
| admin required | boolean |
| canSave | boolean Boolean indicating whether user can save sources to group. Defaults to true. |
{- "userID": 0,
- "admin": true,
- "canSave": true
}{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "user_id": 0,
- "admin": true
}
}Update a group user's admin or save access status
| group_id required | integer |
| userID required | integer |
| admin | boolean Boolean indicating whether user is group admin. Either this
or |
| canSave | boolean Boolean indicating whether user can save sources to group. Either
this or |
{- "userID": 0,
- "admin": true,
- "canSave": true
}{- "status": "success",
- "message": "string"
}Add users from other group(s) to specified group
| group_id required | integer |
| fromGroupIDs required | boolean |
{- "fromGroupIDs": true
}{- "status": "success",
- "message": "string"
}Retrieve a group
| group_id required | integer |
| includeGroupUsers | boolean Boolean indicating whether to include group users. Defaults to true. |
{- "status": "success",
- "message": "string",
- "data": {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- {
- "roles": [
- null
], - "tokens": [
- null
], - "acls": [
- null
], - "username": "string",
- "first_name": "string",
- "last_name": "string",
- "bio": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "is_bot": true,
- "expiration_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "comments_on_gcns": [
- null
], - "reminders_on_gcns": [
- null
], - "comments_on_earthquakes": [
- null
], - "reminders_on_earthquakes": [
- null
], - "default_observationplan_requests": [
- null
], - "default_gcntags": [
- null
], - "catalog_queries": [
- null
], - "comments_on_shifts": [
- null
], - "reminders_on_shifts": [
- null
], - "followup_requests": [
- null
], - "default_followup_requests": [
- null
], - "observationplan_requests": [
- null
], - "survey_efficiency_for_observations": [
- null
], - "survey_efficiency_for_observation_plan": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "assignments": [
- null
], - "recurring_apis": [
- null
], - "gcnevents": [
- null
], - "gcnnotices": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "gcntags": [
- null
], - "gcnproperties": [
- null
], - "earthquakeevents": [
- null
], - "earthquakenotices": [
- null
], - "listings": [
- null
], - "localizations": [
- null
], - "localizationtags": [
- null
], - "localizationproperties": [
- null
], - "notifications": [
- null
], - "observing_runs": [
- null
], - "sources_in_gcn": [
- null
], - "photometryvalidations": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "tns_submissions": [
- null
], - "social_auth": [
- null
], - "saved_sources": [
- null
]
}
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
}Update a group
| group_id required | integer |
| streams | Array of any |
| filters | Array of any |
| shifts | Array of any |
| users | Array of any |
| group_users | Array of any |
| observing_runs | Array of any |
| photometry | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| mmadetector_spectra | Array of any |
| mmadetector_time_intervals | Array of any |
| allocations | Array of any |
| source_labels | Array of any |
| admission_requests | Array of any |
| tnsrobots | Array of any |
| gcnreports | Array of any |
| gcnsummaries | Array of any |
| name required | string Name of the group. |
| nickname | string or null Short group nickname. |
| description | string or null Longer description of the group. |
| private | boolean Boolean indicating whether group is invisible to non-members. |
| single_user_group | boolean or null Flag indicating whether this group is a singleton group for one user only. |
{- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true
}{- "status": "success",
- "message": "string"
}Retrieve all groups
| name | string Fetch by name (exact match) |
| includeSingleUserGroups | boolean Bool indicating whether to include single user groups. Defaults to false. |
{- "status": "success",
- "message": "string",
- "data": {
- "user_groups": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
], - "user_accessible_groups": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
], - "all_groups": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
]
}
}Create a new group
| streams | Array of any |
| filters | Array of any |
| shifts | Array of any |
| users | Array of any |
| group_users | Array of any |
| observing_runs | Array of any |
| photometry | Array of any |
| photometric_series | Array of any |
| spectra | Array of any |
| mmadetector_spectra | Array of any |
| mmadetector_time_intervals | Array of any |
| allocations | Array of any |
| source_labels | Array of any |
| admission_requests | Array of any |
| tnsrobots | Array of any |
| gcnreports | Array of any |
| gcnsummaries | Array of any |
| name required | string Name of the group. |
| nickname | string or null Short group nickname. |
| description | string or null Longer description of the group. |
| private | boolean Boolean indicating whether group is invisible to non-members. |
| single_user_group | boolean or null Flag indicating whether this group is a singleton group for one user only. |
| group_admins | Array of integers List of IDs of users to be group admins. Current user will automatically be added as a group admin. |
{- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "group_admins": [
- 0
]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve a group admission request
| admission_request_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
}Update a group admission request's status
| admission_request_id required | integer |
| status required | string One of either 'accepted', 'declined', or 'pending'. |
{- "status": "string"
}{- "status": "success",
- "message": "string"
}Retrieve all group admission requests
| groupID | integer ID of group for which admission requests are desired |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
]
}Create a new group admission request
| groupID required | integer |
| userID required | integer |
{- "groupID": 0,
- "userID": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve basic info on Groups that an Obj is saved to
| obj_id required | integer |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "streams": [
- null
], - "filters": [
- null
], - "shifts": [
- null
], - "users": [
- null
], - "group_users": [
- null
], - "observing_runs": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "allocations": [
- null
], - "source_labels": [
- null
], - "admission_requests": [
- null
], - "tnsrobots": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "name": "string",
- "nickname": "string",
- "description": "string",
- "private": true,
- "single_user_group": true,
- "id": 0
}
]
}Save or request group(s) to save source, and optionally unsave from group(s).
| objId required | string ID of the object in question. |
| inviteGroupIds required | Array of integers List of group IDs to save or invite to save specified source. |
| unsaveGroupIds | Array of integers List of group IDs from which specified source is to be unsaved. |
{- "objId": "string",
- "inviteGroupIds": [
- 0
], - "unsaveGroupIds": [
- 0
]
}{- "status": "success",
- "message": "string"
}Update a Source table row
| obj_id required | integer |
| groupID required | integer |
| active required | boolean |
| requested required | boolean |
{- "groupID": 0,
- "active": true,
- "requested": true
}{- "status": "success",
- "message": "string"
}Add alert stream access to group
| group_id required | integer |
| stream_id required | integer |
{- "stream_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "stream_id": 0
}
}Grant stream access to a user
| stream_id required | integer |
| user_id required | integer |
{- "user_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "stream_id": 0,
- "user_id": 0
}
}{- "status": "success",
- "message": "string",
- "data": {
- "groups": [
- null
], - "users": [
- null
], - "filters": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "altdata": null,
- "id": 0
}
}Update a stream
| stream_id required | integer |
| name | string |
| altdata | object |
{- "name": "string",
- "altdata": { }
}{- "status": "success",
- "message": "string"
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "groups": [
- null
], - "users": [
- null
], - "filters": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "tnsrobots": [
- null
], - "name": "string",
- "altdata": null,
- "id": 0
}
]
}POST a new stream.
| name required | string |
| altdata | object |
{- "name": "string",
- "altdata": { }
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Add a group user
| group_id required | integer |
| userID required | integer |
| admin required | boolean |
| canSave | boolean Boolean indicating whether user can save sources to group. Defaults to true. |
{- "userID": 0,
- "admin": true,
- "canSave": true
}{- "status": "success",
- "message": "string",
- "data": {
- "group_id": 0,
- "user_id": 0,
- "admin": true
}
}Update a group user's admin or save access status
| group_id required | integer |
| userID required | integer |
| admin | boolean Boolean indicating whether user is group admin. Either this
or |
| canSave | boolean Boolean indicating whether user can save sources to group. Either
this or |
{- "userID": 0,
- "admin": true,
- "canSave": true
}{- "status": "success",
- "message": "string"
}Add users from other group(s) to specified group
| group_id required | integer |
| fromGroupIDs required | boolean |
{- "fromGroupIDs": true
}{- "status": "success",
- "message": "string"
}Retrieve a group admission request
| admission_request_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
}Update a group admission request's status
| admission_request_id required | integer |
| status required | string One of either 'accepted', 'declined', or 'pending'. |
{- "status": "string"
}{- "status": "success",
- "message": "string"
}Retrieve all group admission requests
| groupID | integer ID of group for which admission requests are desired |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
]
}Create a new group admission request
| groupID required | integer |
| userID required | integer |
{- "groupID": 0,
- "userID": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Get a summary of all the activity of shift users on skyportal for a given period
| shift_id required | integer |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by shift.start_date >= startDate |
{- "status": "success",
- "message": "string"
}Add a shift user
| shift_id required | integer |
| userID required | integer |
| admin required | boolean |
{- "userID": 0,
- "admin": true
}{- "status": "success",
- "message": "string",
- "data": {
- "shift_id": 0,
- "user_id": 0,
- "admin": true,
- "needs_replacement": true
}
}Update a shift user's admin status, or needs_replacement status
| shift_id required | integer |
| userID required | integer |
| admin | boolean Boolean indicating whether user is shift admin. |
| needs_replacement | boolean Boolean indicating whether user needs replacement or not |
{- "userID": 0,
- "admin": true,
- "needs_replacement": true
}{- "status": "success",
- "message": "string"
}Grant stream access to a user
| stream_id required | integer |
| user_id required | integer |
{- "user_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "stream_id": 0,
- "user_id": 0
}
}{- "status": "success",
- "message": "string",
- "data": {
- "roles": [
- null
], - "tokens": [
- null
], - "acls": [
- null
], - "username": "string",
- "first_name": "string",
- "last_name": "string",
- "bio": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "is_bot": true,
- "expiration_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "comments_on_gcns": [
- null
], - "reminders_on_gcns": [
- null
], - "comments_on_earthquakes": [
- null
], - "reminders_on_earthquakes": [
- null
], - "default_observationplan_requests": [
- null
], - "default_gcntags": [
- null
], - "catalog_queries": [
- null
], - "comments_on_shifts": [
- null
], - "reminders_on_shifts": [
- null
], - "followup_requests": [
- null
], - "default_followup_requests": [
- null
], - "observationplan_requests": [
- null
], - "survey_efficiency_for_observations": [
- null
], - "survey_efficiency_for_observation_plan": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "assignments": [
- null
], - "recurring_apis": [
- null
], - "gcnevents": [
- null
], - "gcnnotices": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "gcntags": [
- null
], - "gcnproperties": [
- null
], - "earthquakeevents": [
- null
], - "earthquakenotices": [
- null
], - "listings": [
- null
], - "localizations": [
- null
], - "localizationtags": [
- null
], - "localizationproperties": [
- null
], - "notifications": [
- null
], - "observing_runs": [
- null
], - "sources_in_gcn": [
- null
], - "photometryvalidations": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "tns_submissions": [
- null
], - "social_auth": [
- null
], - "saved_sources": [
- null
]
}
}Update a User record
| user_id required | integer |
| expirationDate | string Arrow-parseable date string (e.g. 2020-01-01). Set a user's expiration date, after which the user's account will be deactivated and will be unable to access the application. |
{- "expirationDate": "string"
}{- "status": "success",
- "message": "string"
}Retrieve all users
| numPerPage | integer Number of candidates to return per paginated request. Defaults to all users |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
| firstName | string Get users whose first name contains this string. |
| lastName | string Get users whose last name contains this string. |
| username | string Get users whose username contains this string. |
string Get users whose email contains this string. | |
| role | string Get users with the role. |
| acl | string Get users with this ACL. |
| group | string Get users part of the group with name given by this parameter. |
| stream | string Get users with access to the stream with name given by this parameter. |
{- "status": "success",
- "message": "string",
- "data": {
- "users": [
- {
- "roles": [
- null
], - "tokens": [
- null
], - "acls": [
- null
], - "username": "string",
- "first_name": "string",
- "last_name": "string",
- "bio": "string",
- "affiliations": null,
- "contact_email": "string",
- "contact_phone": "string",
- "oauth_uid": "string",
- "preferences": null,
- "is_bot": true,
- "expiration_date": "2019-08-24T14:15:22Z",
- "id": 0,
- "group_admission_requests": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "shifts": [
- null
], - "comments": [
- null
], - "reminders": [
- null
], - "annotations": [
- null
], - "photometry": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "mmadetector_spectra": [
- null
], - "mmadetector_time_intervals": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "comments_on_gcns": [
- null
], - "reminders_on_gcns": [
- null
], - "comments_on_earthquakes": [
- null
], - "reminders_on_earthquakes": [
- null
], - "default_observationplan_requests": [
- null
], - "default_gcntags": [
- null
], - "catalog_queries": [
- null
], - "comments_on_shifts": [
- null
], - "reminders_on_shifts": [
- null
], - "followup_requests": [
- null
], - "default_followup_requests": [
- null
], - "observationplan_requests": [
- null
], - "survey_efficiency_for_observations": [
- null
], - "survey_efficiency_for_observation_plan": [
- null
], - "transactions": [
- null
], - "transaction_requests": [
- null
], - "assignments": [
- null
], - "recurring_apis": [
- null
], - "gcnevents": [
- null
], - "gcnnotices": [
- null
], - "gcnreports": [
- null
], - "gcnsummaries": [
- null
], - "gcntags": [
- null
], - "gcnproperties": [
- null
], - "earthquakeevents": [
- null
], - "earthquakenotices": [
- null
], - "listings": [
- null
], - "localizations": [
- null
], - "localizationtags": [
- null
], - "localizationproperties": [
- null
], - "notifications": [
- null
], - "observing_runs": [
- null
], - "sources_in_gcn": [
- null
], - "photometryvalidations": [
- null
], - "source_notifications": [
- null
], - "sources": [
- null
], - "tns_submissions": [
- null
], - "social_auth": [
- null
], - "saved_sources": [
- null
]
}
], - "totalMatches": 0
}
}Add a new user
| username required | string |
| first_name | string |
| last_name | string |
| affiliations | Array of strings |
| contact_email | string |
| oauth_uid | string |
| contact_phone | string |
| roles | Array of strings List of user roles. Defaults to |
| groupIDsAndAdmin | Array of arrays Array of 2-element arrays |
{- "username": "string",
- "first_name": "string",
- "last_name": "string",
- "affiliations": [
- "string"
], - "contact_email": "string",
- "oauth_uid": "string",
- "contact_phone": "string",
- "roles": [
- "string"
], - "groupIDsAndAdmin": [
- [ ]
]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve a Multimessenger Astronomical Detector (MMADetector)
| mmadetector_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true,
- "id": 0
}
}Update a Multimessenger Astronomical Detector (MMADetector)
| mmadetector_id required | integer |
| events | Array of any |
| spectra | Array of any |
| time_intervals | Array of any |
| name required | string Unabbreviated facility name (e.g., LIGO Hanford Observatory. |
| nickname required | string Abbreviated facility name (e.g., H1). |
| type required | string <= 18 characters Enum: "gravitational-wave" "neutrino" "gamma-ray-burst" MMA detector type, one of gravitational wave, neutrino, or gamma-ray burst. |
| lat | number or null Latitude in deg. |
| lon | number or null Longitude in deg. |
| elevation | number or null Elevation in meters. |
| fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true
}{- "status": "success",
- "message": "string"
}Retrieve all Multimessenger Astronomical Detectors (MMADetectors)
| name | string Filter by name |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true,
- "id": 0
}
]
}Create a Multimessenger Astronomical Detector (MMADetector)
| events | Array of any |
| spectra | Array of any |
| time_intervals | Array of any |
| name required | string Unabbreviated facility name (e.g., LIGO Hanford Observatory. |
| nickname required | string Abbreviated facility name (e.g., H1). |
| type required | string <= 18 characters Enum: "gravitational-wave" "neutrino" "gamma-ray-burst" MMA detector type, one of gravitational wave, neutrino, or gamma-ray burst. |
| lat | number or null Latitude in deg. |
| lon | number or null Longitude in deg. |
| elevation | number or null Elevation in meters. |
| fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "events": [
- null
], - "spectra": [
- null
], - "time_intervals": [
- null
], - "name": "string",
- "nickname": "string",
- "type": "gravitational-wave",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "fixed_location": true
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve an mmadetector spectrum
| spectrum_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "detector": null,
- "groups": [
- null
], - "owner": null,
- "frequencies": [
- 0
], - "amplitudes": [
- 0
], - "start_time": "2019-08-24T14:15:22Z",
- "end_time": "2019-08-24T14:15:22Z",
- "detector_id": 0,
- "owner_id": 0,
- "original_file_string": "string",
- "original_file_filename": "string",
- "id": 0
}
}Update mmadetector spectrum
| spectrum_id required | integer |
| start_time required | string <date-time> The ISO UTC start time the spectrum was taken. |
| end_time required | string <date-time> The ISO UTC end time the spectrum was taken. |
| detector_id required | integer ID of the MMADetector that acquired the Spectrum. |
| amplitudes required | Array of numbers Amplitude of the Spectrum [1/sqrt(Hz). |
| frequencies required | Array of numbers Frequencies of the spectrum [Hz]. |
| group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
{- "start_time": "2019-08-24T14:15:22Z",
- "end_time": "2019-08-24T14:15:22Z",
- "detector_id": 0,
- "amplitudes": [
- 0
], - "frequencies": [
- 0
], - "group_ids": [ ]
}{- "status": "success",
- "message": "string"
}Retrieve multiple spectra with given criteria
| observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed before this time. |
| observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only spectra observed after this time. |
| detectorIDs | any If provided, filter only spectra observed with one of these mmadetector IDs. |
| groupIDs | list If provided, filter only spectra saved to one of these group IDs. |
Upload a Multimessenger Astronomical Detector (MMADetector) spectrum
| start_time required | string <date-time> The ISO UTC start time the spectrum was taken. |
| end_time required | string <date-time> The ISO UTC end time the spectrum was taken. |
| detector_id required | integer ID of the MMADetector that acquired the Spectrum. |
| amplitudes required | Array of numbers Amplitude of the Spectrum [1/sqrt(Hz). |
| frequencies required | Array of numbers Frequencies of the spectrum [Hz]. |
| group_ids | any Default: [] IDs of the Groups to share this spectrum with. Set to "all" to make this spectrum visible to all users. |
{- "start_time": "2019-08-24T14:15:22Z",
- "end_time": "2019-08-24T14:15:22Z",
- "detector_id": 0,
- "amplitudes": [
- 0
], - "frequencies": [
- 0
], - "group_ids": [ ]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve an mmadetector time_interval
| time_interval_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "detector": null,
- "groups": [
- null
], - "owner": null,
- "detector_id": 0,
- "owner_id": 0,
- "id": 0
}
}Update mmadetector time_interval
| time_interval_id required | integer |
| detector | any or null The MMADetector that acquired the Time Interval. |
| groups | Array of any |
| owner | any or null The User who uploaded the detector time interval. |
| detector_id required | integer ID of the MMADetector that acquired the Time Interval. |
{- "detector": null,
- "groups": [
- null
], - "owner": null,
- "detector_id": 0
}{- "status": "success",
- "message": "string"
}Retrieve multiple time_intervals with given criteria
| observedBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only time_interval observed before this time. |
| observedAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only time_interval observed after this time. |
| detectorIDs | any If provided, filter only time_intervals observed with one of these mmadetector IDs. |
| groupIDs | list If provided, filter only time_interval saved to one of these group IDs. |
Upload a Multimessenger Astronomical Detector (MMADetector) time_interval(s)
| detector | any or null The MMADetector that acquired the Time Interval. |
| groups | Array of any |
| owner | any or null The User who uploaded the detector time interval. |
| detector_id required | integer ID of the MMADetector that acquired the Time Interval. |
{- "detector": null,
- "groups": [
- null
], - "owner": null,
- "detector_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve sources from a user's lists
| user_id required | string |
| listName | string name of the list to retrieve objects from. If not given will return all objects saved by the user to all lists. |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "user": null,
- "obj": null,
- "user_id": 0,
- "obj_id": "string",
- "list_name": "string",
- "params": null,
- "id": 0
}
]
}Add a listing.
| user_id | integer ID of user that you want to add the listing to. If not given, will default to the associated user object that is posting. |
| obj_id | string |
| list_name | string Listing name for this item, e.g., "favorites". Multiple objects can be saved by the same user to different lists, where the list names are user-defined. List name must be a non-empty string starting with an alphanumeric character or underscore. (it must match the regex: /^\w+/) |
| params | object Optional parameters for "watchlist" type listings, when searching for new candidates around a given object. For example, if you want to search for new candidates around a given object, you can specify the search radius and the number of candidates to return. The parameters are passed to the microservice that is responsible for processing the listing. The microservice will return a list of candidates that match the given parameters, and ingest them. |
{- "user_id": 0,
- "obj_id": "string",
- "list_name": "string",
- "params": { }
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Remove an existing listing
| listing_id required | integer ID of the listing object. If not given, must supply the listing's obj_id and list_name (and user_id) to find the correct listing id from that info. |
| user_id | integer ID of user that you want to add the listing to. If not given, will default to the associated user object that is posting. |
| obj_id | string |
| list_name | string Listing name for this item, e.g., "favorites". |
{- "user_id": 0,
- "obj_id": "string",
- "list_name": "string"
}{- "status": "success",
- "message": "string"
}Update an existing listing
| listing_id required | integer |
| user_id | integer |
| obj_id | string |
| list_name | string Listing name for this item, e.g., "favorites". Multiple objects can be saved by the same user to different lists, where the list names are user-defined. List name must be a non-empty string starting with an alphanumeric character or underscore. (it must match the regex: /^\w+/) |
{- "user_id": 0,
- "obj_id": "string",
- "list_name": "string"
}{- "status": "success",
- "message": "string"
}Retrieve a group admission request
| admission_request_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
}Update a group admission request's status
| admission_request_id required | integer |
| status required | string One of either 'accepted', 'declined', or 'pending'. |
{- "status": "string"
}{- "status": "success",
- "message": "string"
}Retrieve all group admission requests
| groupID | integer ID of group for which admission requests are desired |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "user": null,
- "group": null,
- "user_id": 0,
- "group_id": 0,
- "status": "pending",
- "id": 0
}
]
}Create a new group admission request
| groupID required | integer |
| userID required | integer |
{- "groupID": 0,
- "userID": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Add log messages from an instrument
| instrument_id required | integer The instrument ID to post logs for |
| start_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
| end_date required | string Arrow-parseable date string (e.g. 2020-01-01). |
| logs required | object Nested JSON containing the log messages. |
{- "start_date": "string",
- "end_date": "string",
- "logs": { }
}{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Retrieve queued observations from external API
| allocation_id required | string ID for the allocation to retrieve |
| startDate required | string Arrow-parseable date string (e.g. 2020-01-01). Defaults to now. |
| endDate required | string Arrow-parseable date string (e.g. 2020-01-01). Defaults to 72 hours ago. |
{- "status": "success",
- "message": "string"
}Retrieve all observations
| telescopeName | string Filter by telescope name |
| instrumentName | string Filter by instrument name |
| startDate required | string Filter by start date |
| endDate required | string Filter by end date |
| localizationDateobs | string Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
| returnStatistics | boolean Boolean indicating whether to include integrated probability and area. Defaults to false. |
| statsMethod | string Method to use for computing integrated probability and area. Defaults to 'python'. To use the database/postgres based method, use 'db'. |
| statsLogging | boolean Boolean indicating whether to log the stats computation time. Defaults to false. |
| includeGeoJSON | boolean Boolean indicating whether to include associated GeoJSON. Defaults to false. |
| observationStatus | str Whether to include queued or executed observations. Defaults to executed. |
| numberObservations | number Minimum number of observations of a field required to include. Defaults to 1. |
| numPerPage | integer Number of followup requests to return per paginated request. Defaults to 100. Can be no larger than {MAX_OBSERVATIONS}. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
| sortBy | string The field to sort by. |
| sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2019-08-24T14:15:22Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
]
}Ingest a set of ExecutedObservations
| instrumentName required | string The instrument name associated with the fields |
| observationData | any Observation data dictionary list |
| telescopeName required | string The telescope name associated with the fields |
{- "instrumentName": "string",
- "observationData": null,
- "telescopeName": "string"
}{- "status": "success",
- "message": "string"
}Upload observation from ASCII file
| observationData | any Observation data Ascii string |
| instrumentID required | string The instrument ID associated with the fields |
{- "observationData": null,
- "instrumentID": "string"
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2019-08-24T14:15:22Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
]
}Perform simsurvey efficiency calculation
| instrument_id required | string ID for the instrument to submit |
| startDate required | string Filter by start date |
| endDate required | string Filter by end date |
| localizationDateobs required | string Event time in ISO 8601 format ( |
| localizationName | string Name of localization / skymap to use. Can be found in Localization.localization_name queried from /api/localization endpoint or skymap name in GcnEvent page table. |
| localizationCumprob | number Cumulative probability up to which to include fields. Defaults to 0.95. |
| numberInjections | number Number of simulations to evaluate efficiency with. Defaults to 1000. |
| numberDetections | number Number of detections required for detection. Defaults to 1. |
| detectionThreshold | number Threshold (in sigmas) required for detection. Defaults to 5. |
| minimumPhase | number Minimum phase (in days) post event time to consider detections. Defaults to 0. |
| maximumPhase | number Maximum phase (in days) post event time to consider detections. Defaults to 3. |
| model_name | string Model to simulate efficiency for. Must be one of kilonova, afterglow, or linear. Defaults to kilonova. |
| optionalInjectionParameters | any |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view the analyses. Defaults to all of requesting user's groups. |
{- "status": "success",
- "message": "string"
}Retrieve queued observations from external API
| allocation_id required | string ID for the allocation to retrieve |
| startDate | string Filter by start date |
| endDate | string Filter by end date |
| queuesOnly | bool Return queue only (do not commit observations) |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "instrument": null,
- "field": null,
- "observation_plan_id": 0,
- "instrument_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "field_id": 0,
- "exposure_time": 0,
- "weight": 0,
- "filt": "string",
- "obstime": "2019-08-24T14:15:22Z",
- "overhead_per_exposure": 0,
- "planned_observation_id": 0,
- "id": 0
}
]
}Delete queued observations from external API
| allocation_id required | string ID for the allocation to delete queue |
| queueName required | string Queue name to remove |
{- "status": "success",
- "message": "string"
}Retrieve observations from external API
| start_date required | any start date of the request. |
| allocation_id required | integer Followup request allocation ID. |
| end_date required | any end date of the request. |
{- "start_date": null,
- "allocation_id": 0,
- "end_date": null
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "field": null,
- "instrument_id": 0,
- "instrument_field_id": 0,
- "observation_id": 0,
- "obstime": "2019-08-24T14:15:22Z",
- "filt": "string",
- "exposure_time": 0,
- "airmass": 0,
- "seeing": 0,
- "limmag": 0,
- "target_name": "string",
- "processed_fraction": 0,
- "id": 0
}
]
}Retrieve skymap-based trigger from external API
| allocation_id required | string ID for the allocation to retrieve |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "observation_plan": null,
- "instrument": null,
- "field": null,
- "observation_plan_id": 0,
- "instrument_id": 0,
- "dateobs": "2019-08-24T14:15:22Z",
- "field_id": 0,
- "exposure_time": 0,
- "weight": 0,
- "filt": "string",
- "obstime": "2019-08-24T14:15:22Z",
- "overhead_per_exposure": 0,
- "planned_observation_id": 0,
- "id": 0
}
]
}Delete skymap-based trigger from external API
| allocation_id required | string ID for the allocation to delete queue |
| queueName required | string Queue name to remove |
{- "status": "success",
- "message": "string"
}Retrieve invitations
| includeUsed | boolean Bool indicating whether to include used invitations. Defaults to false. |
| numPerPage | integer Number of candidates to return per paginated request. Defaults to 25 |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
string Get invitations whose email contains this string. | |
| group | string Get invitations part of the group with name given by this parameter. |
| stream | string Get invitations with access to the stream with name given by this parameter. |
| invitedBy | string Get invitations invited by users whose username contains this string. |
{- "status": "success",
- "message": "string",
- "data": {
- "invitations": [
- {
- "role": null,
- "groups": [
- null
], - "streams": [
- null
], - "invited_by": null,
- "token": "string",
- "role_id": "string",
- "admin_for_groups": [
- true
], - "can_save_to_groups": [
- true
], - "user_email": "string",
- "used": true,
- "user_expiration_date": "2019-08-24T14:15:22Z",
- "id": 0
}
], - "totalMatches": 0
}
}Invite a new user
| userEmail required | string |
| role | string The role the new user will have in the system. If provided, must be one of either "Full user" or "View only". Defaults to "Full user". |
| streamIDs | Array of integers List of IDs of streams invited user will be given access to. If
not provided, user will be granted access to all streams associated
with the groups specified by |
| groupIDs required | Array of integers List of IDs of groups invited user will be added to. If |
| groupAdmin | Array of booleans List of booleans indicating whether user should be granted admin status for respective specified group(s). Defaults to all false. |
| canSave | Array of booleans List of booleans indicating whether user should be able to save sources to respective specified group(s). Defaults to all true. |
| userExpirationDate | string Arrow-parseable date string (e.g. 2020-01-01). Set a user's expiration date, after which the user's account will be deactivated and will be unable to access the application. |
{- "userEmail": "string",
- "role": "string",
- "streamIDs": [
- 0
], - "groupIDs": [
- 0
], - "groupAdmin": [
- true
], - "canSave": [
- true
], - "userExpirationDate": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": "string"
}
}Update a pending invitation
| groupIDs | Array of integers |
| streamIDs | Array of integers |
| role | string |
| userExpirationDate | string Arrow-parseable date string (e.g. 2020-01-01). Set a user's expiration date, after which the user's account will be deactivated and will be unable to access the application. |
{- "groupIDs": [
- 0
], - "streamIDs": [
- 0
], - "role": "string",
- "userExpirationDate": "string"
}{- "status": "success",
- "message": "string"
}Retrieve an observation efficiency analysis
| survey_efficiency_analysis_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "gcnevent": null,
- "localization": null,
- "instrument": null,
- "requester": null,
- "groups": [
- null
], - "gcnevent_id": 0,
- "localization_id": 0,
- "instrument_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
}Remove observations from treasuremap.space.
| instrument_id required | string ID for the instrument to submit |
| localizationDateobs | string Event time in ISO 8601 format ( |
{- "status": "success",
- "message": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "assignments": [
- null
], - "pi": "string",
- "calendar_date": "2019-08-24",
- "instrument": null,
- "instrument_id": 0,
- "observers": "string",
- "ephemeris": null,
- "owner_id": 0,
- "group_id": 0,
- "id": 0
}
}Update observing run
| run_id required | integer |
| pi | string The PI of the observing run. |
| calendar_date required | string <date> The local calendar date of the run. |
| instrument_id required | integer The ID of the instrument to be used in this run. |
| observers | string The names of the observers |
| group_id | integer The ID of the group this run is associated with. |
{- "pi": "string",
- "calendar_date": "2019-08-24",
- "instrument_id": 0,
- "observers": "string",
- "group_id": 0
}{- "status": "success",
- "message": "string"
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "instrument": null,
- "sources": [
- null
], - "group": null,
- "owner": null,
- "assignments": [
- null
], - "instrument_id": 0,
- "pi": "string",
- "observers": "string",
- "group_id": 0,
- "owner_id": 0,
- "calendar_date": "2019-08-24",
- "run_end_utc": "2019-08-24T14:15:22Z",
- "id": 0
}
]
}Add a new observing run
| pi | string The PI of the observing run. |
| calendar_date required | string <date> The local calendar date of the run. |
| instrument_id required | integer The ID of the instrument to be used in this run. |
| observers | string The names of the observers |
| group_id | integer The ID of the group this run is associated with. |
{- "pi": "string",
- "calendar_date": "2019-08-24",
- "instrument_id": 0,
- "observers": "string",
- "group_id": 0
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve an observation plan efficiency analysis
| survey_efficiency_analysis_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "observation_plan": null,
- "requester": null,
- "groups": [
- null
], - "observation_plan_id": 0,
- "id": 0,
- "payload": null,
- "status": "string",
- "lightcurves": null,
- "requester_id": 0
}
}Set an object's host galaxy
| obj_id required | string |
| galaxyName required | string Name of the galaxy to associate with the object |
{- "galaxyName": "string"
}{- "status": "success",
- "message": "string"
}Retrieve an object's in-out critera for GcnEvents
| obj_id required | string |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by GcnEvent.dateobs >= startDate. |
| endDate | string Arrow-parseable date string (e.g. 2020-01-01). If provided, filter by GcnEvent.dateobs <= startDate. |
{- "startDate": "string",
- "endDate": "string"
}{- "status": "success",
- "message": "string"
}Retrieve an object's status from Minor Planet Center
| obj_id required | string |
| obscode | string Minor planet center observatory code. Defaults to 500, corresponds to geocentric. |
| date | string Time to check MPC for. Defaults to current time. |
| limiting_magnitude | float Limiting magnitude down which to search. Defaults to 24.0. |
| search_radius | float Search radius for MPC [in arcmin]. Defaults to 1 arcminute. |
{- "obscode": "string",
- "date": "string",
- "limiting_magnitude": null,
- "search_radius": null
}{- "status": "success",
- "message": "string"
}Retrieve objects from TNS
| tnsrobotID required | int TNS Robot ID. |
| startDate | string Arrow-parseable date string (e.g. 2020-01-01). Filter by public_timestamp >= startDate. Defaults to one day ago. |
| groupIds required | Array of integers List of IDs of groups to indicate labelling for |
{- "tnsrobotID": null,
- "startDate": "string",
- "groupIds": [
- 0
]
}{- "status": "success",
- "message": "string"
}Validate or reject a photometric point based on data quality (e.g. examining quality of the image and/or reduction)
| photometry_id required | int Photometry ID |
| validated required | boolean Whether the source is validated (True) or rejected (False) |
{- "validated": true
}{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Deletes the validated or rejected status of a photometric point. Its status can be considered as 'undefined'.
| photometric_id required | int |
{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Update the validated or rejected status of a source in a GCN
| photometry_id required | int |
| validated required | boolean Whether the photometry is validated (True) or rejected (False) |
{- "validated": true
}{- "status": "success",
- "message": "string",
- "data": {
- "id": null
}
}Retrieve a photometric series
| photometric_series_id required | integer |
| dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}
}Retrieve all photometric series, based on various cuts.
| dataFormat | string Enum: "json" "hdf5" "none" Format of the data to return. If |
| ra | number RA for spatial filtering (in decimal degrees) |
| dec | number Declination for spatial filtering (in decimal degrees) |
| radius | number Radius for spatial filtering if ra & dec are provided (in decimal degrees) |
| objectID | string Portion of ID to filter on |
| rejectedObjectIDs | str Comma-separated string of object IDs not to be returned, useful in cases where you are looking for new objects passing a query. |
| seriesName | string Get series that match this name. The match must be exact. This is useful when getting photometry for multiple objects taken at the same time (e.g., for calibrating against each other). The series name can be, e.g., a TESS sector, or a date/field name identifier. Generally a series name is shared only by data taken over that same time period. |
| seriesObjID | string Get only photometry for the objects named by this object id. This is the internal naming used inside each photometric series, i.e., the index used for each source in the images that were used to create the photometric series. Not the same as the SkyPortal object ID. E.g., this could be a TESS TIC ID, or some internal numbering used in the specific field that was observed. |
| filter | string Retrieve only series matching this filter, e.g., "ztfg". |
| channel | string The channel name/id to filter on. |
| origin | string The origin can be anything that gives an idea of the provenance of the photometric series. This can be, e.g., the name of the pipeline that produced the photometry from the images, or the level of calibration, or any other pre-defined string that identifies where the data came from that isn't covered by the other fields (like channel or filter or instrument). |
| filename | string Portion of filename to filter on. If the filename is a relative path, will append the data directory from the config file to the beginning of the filename. (by default that is 'persistentdata/phot_series'). |
| startBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started before this time. |
| startAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that started after this time. |
| midTimeBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed before this time. |
| midTimeAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series where the middle of the series was observed after this time. |
| endBefore | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended before this time. |
| endAfter | string Arrow-parseable date string (e.g. 2020-01-01). If provided, return only series that ended after this time. |
| detected | boolean If true, get only series with one or more detections. If false, get only series with no detections. If left out, do not filter at all on detection status. |
| expTime | number Get only series with this exact exposure time (seconds). |
| minExpTime | number Get only series with an exposure time above/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
| maxExpTime | number Get only series with an exposure time under/equal to this. If the series was not uploaded with one specific number, the exposure time for the series is the median of the exposure times of the individual images. |
| minFrameRate | number Get only series with a frame rate higher/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
| maxFrameRate | number Get only series with a frame rate lower/equal to than this. Frame rates are the inverse of the median time between exposures, in units of 1/s (Hz). |
| minNumExposures | number Get only series with this many exposures, or more. |
| maxNumExposures | number Get only series with this many exposures, or less. |
| instrumentID | number get only series taken with this instrument. |
| followupRequestID | number get only series taken with this followup request. |
| assignmentID | number get only series taken with this assignment. |
| ownerID | number get only series uploaded by this user. |
| magBrighterThan | number get only series with mean_mag brighter or equal to this value. |
| magFainterThan | number get only series with mean_mag fainter or equal to this value. |
| limitingMagBrighterThan | number Retrieve only series with limiting mags brighter or equal to this value. |
| limitingMagFainterThan | number Retrieve only series with limiting mags fainter or equal to this value. |
| limitingMagIsNone | boolean Retrieve only series that do not have limiting mag. |
| magrefBrighterThan | number Get only series that have a magref, and that the magref is brighter or equal to this value. |
| magrefFainterThan | number Get only series that have a magref, and that the magref is fainter or equal to this value. |
| maxRMS | number get only series with rms_mag less than this. |
| minRMS | number get only series with rms_mag more than this. |
| useRobustMagAndRMS | boolean If true, will use the robust_mag and robust_rms values instead of mean_mag and rms_mag when filtering on mean magnitude or RMS. Does not affect the magref query. |
| maxMedianSNR | number Get only series where the median S/N is less than this. The S/N is calculated using the robust RMS. |
| minMedianSNR | number Get only series where the median S/N is more than this. The S/N is calculated using the robust RMS. |
| maxBestSNR | number Get only series where the maximum S/N is less than this. The S/N is calculated using the robust RMS. |
| minBestSNR | number Get only series where the maximum S/N is more than this. The S/N is calculated using the robust RMS. |
| maxWorstSNR | number Get only series where the lowest S/N is less than this. The S/N is calculated using the robust RMS. |
| minWorstSNR | number Get only series where the lowest S/N is more than this. The S/N is calculated using the robust RMS. |
| hash | string Get only a series that matches this file hash. This is useful if you have an HDF5 file downloaded from the SkyPortal backend, and want to associate it with a PhotometrySeries object. We use an MD5 hash of the file contents. |
| sortBy | string The field to sort by. Currently allowed options are ["id", "ra", "dec", "redshift", "saved_at"] |
| sortOrder | string The sort order - either "asc" or "desc". Defaults to "asc" |
| numPerPage | integer Number of sources to return per paginated request. Defaults to 100. Max 500. |
| pageNumber | integer Page number for paginated query results. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "series": [
- {
- "obj": null,
- "groups": [
- null
], - "streams": [
- null
], - "instrument": null,
- "followup_request": null,
- "assignment": null,
- "owner": null,
- "obj_id": "string",
- "series_name": "string",
- "series_obj_id": "string",
- "filter": "bessellux",
- "channel": "string",
- "origin": "string",
- "filename": "string",
- "mjd_first": 0,
- "mag_first": 0,
- "mjd_mid": 0,
- "mjd_last": 0,
- "mag_last": 0,
- "mjd_last_detected": 0,
- "mag_last_detected": 0,
- "is_detected": true,
- "exp_time": 0,
- "frame_rate": 0,
- "num_exp": 0,
- "time_stamp_alignment": "start",
- "ra_unc": 0,
- "dec_unc": 0,
- "limiting_mag": 0,
- "ref_flux": 0,
- "ref_fluxerr": 0,
- "altdata": null,
- "instrument_id": 0,
- "followup_request_id": 0,
- "assignment_id": 0,
- "owner_id": 0,
- "mean_mag": 0,
- "rms_mag": 0,
- "robust_mag": 0,
- "robust_rms": 0,
- "median_snr": 0,
- "best_snr": 0,
- "worst_snr": 0,
- "medians": null,
- "maxima": null,
- "minima": null,
- "stds": null,
- "hash": "string",
- "autodelete": true,
- "ra": 0,
- "dec": 0,
- "id": 0
}
], - "totalMatches": 0,
- "pageNumber": 0,
- "numPerPage": 0
}
}Get a list of sources with summaries matching the query
| q | string The query string. E.g. "What sources are associated with an NGC galaxy?" |
| objID | string The objID of the source which has a summary to be used as the query. That is, return the list of sources most similar to the summary of this source. Ignored if q is provided. |
| k | int Max number of sources to return. Default 5. |
| z_min | float Minimum redshift to consider of queries sources. If None or missing, then no lower limit is applied. |
| z_max | float Maximum redshift to consider of queries sources. If None or missing, then no upper limit is applied. |
| classificationTypes | Array of strings List of classification types to consider. If [] or missing, then all classification types are considered. |
{- "status": "success",
- "message": "string",
- "data": {
- "sources": [
- {
- "host": null,
- "comments": [
- null
], - "reminders": [
- null
], - "comments_on_spectra": [
- null
], - "reminders_on_spectra": [
- null
], - "annotations": [
- null
], - "annotations_on_spectra": [
- null
], - "annotations_on_photometry": [
- null
], - "classifications": [
- null
], - "photometry": [
- null
], - "photstats": [
- null
], - "photometric_series": [
- null
], - "spectra": [
- null
], - "thumbnails": [
- null
], - "followup_requests": [
- null
], - "assignments": [
- null
], - "obj_notifications": [
- null
], - "obj_analyses": [
- null
], - "sources_in_gcns": [
- null
], - "tns_submissions": [
- null
], - "id": "string",
- "ra_dis": 0,
- "dec_dis": 0,
- "ra_err": 0,
- "dec_err": 0,
- "offset": 0,
- "redshift": 0,
- "redshift_error": 0,
- "redshift_origin": "string",
- "redshift_history": null,
- "host_id": 0,
- "summary": "string",
- "summary_history": null,
- "altdata": null,
- "dist_nearest_source": 0,
- "mag_nearest_source": 0,
- "e_mag_nearest_source": 0,
- "transient": true,
- "varstar": true,
- "is_roid": true,
- "mpc_name": "string",
- "gcn_crossmatch": null,
- "tns_name": "string",
- "tns_info": null,
- "score": 0,
- "origin": "string",
- "alias": null,
- "internal_key": "string",
- "detect_photometry_count": 0,
- "ra": 0,
- "dec": 0,
- "candidates": [
- null
], - "sources": [
- null
], - "users": [
- null
]
}
]
}
}Share data with additional groups/users
| photometryIDs | Array of integers IDs of the photometry data to be shared. If |
| spectrumIDs | Array of integers IDs of the spectra to be shared. If |
| groupIDs required | Array of integers List of IDs of groups data will be shared with. To share data with a single user, specify their single user group ID here. |
{- "photometryIDs": [
- 0
], - "spectrumIDs": [
- 0
], - "groupIDs": [
- 0
]
}{- "status": "success",
- "message": "string"
}Retrieve an Recurring API by id
| recurring_api_id required | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "owner": null,
- "owner_id": 0,
- "endpoint": "string",
- "payload": null,
- "method": "string",
- "next_call": "2019-08-24T14:15:22Z",
- "call_delay": 0,
- "number_of_retries": 0,
- "active": true,
- "id": 0
}
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "owner": null,
- "owner_id": 0,
- "endpoint": "string",
- "payload": null,
- "method": "string",
- "next_call": "2019-08-24T14:15:22Z",
- "call_delay": 0,
- "number_of_retries": 0,
- "active": true,
- "id": 0
}
]
}POST a new Recurring APIs.
| endpoint required | string Endpoint of the API call. |
| method required | string HTTP method of the API call. |
| next_call required | datetime Time of the next API call. |
| call_delay required | number Delay until next API call in days. |
| number_of_retries | integer Number of retries before service is deactivated. |
| payload required | object Payload of the API call. |
{- "endpoint": "string",
- "method": "string",
- "next_call": null,
- "call_delay": 0,
- "number_of_retries": 0,
- "payload": { }
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Grant new Role(s) to a user
| user_id required | integer |
| roleIds required | Array of strings Array of Role IDs (strings) to be granted to user |
{- "roleIds": [
- "string"
]
}{- "status": "success",
- "message": "string"
}Note that a source has been labelled.
| obj_id required | string ID of object to indicate source labelling for |
| groupIds required | Array of integers List of IDs of groups to indicate labelling for |
{- "groupIds": [
- 0
]
}{- "status": "success",
- "message": "string"
}Send out a new source notification
| additionalNotes | string Notes to append to the message sent out |
| groupIds required | Array of integers List of IDs of groups whose members should get the notification (if they've opted in) |
| sourceId required | string The ID of the Source's Obj the notification is being sent about |
| level required | string Either 'soft' or 'hard', determines whether to send an email or email+SMS notification |
{- "additionalNotes": "string",
- "groupIds": [
- 0
], - "sourceId": "string",
- "level": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": "string"
}
}Retrieve parts of the config file that are exposed to the user/browser
{- "status": "success",
- "message": "string",
- "data": {
- "invitationsEnabled": true,
- "slackPreamble": "string",
- "cosmology": "string",
- "cosmoref": "string",
- "allowedSpectrumTypes": [ ],
- "defaultSpectrumType": "string",
- "classificationsClasses": { }
}
}{- "status": "success",
- "message": "string",
- "data": {
- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true,
- "id": 0
}
}Update taxonomy
| taxonomy_id required | integer |
| groups | Array of any |
| classifications | Array of any |
| name required | string Short string to make this taxonomy memorable to end users. |
| hierarchy required | any Nested JSON describing the taxonomy which should be validated against a schema before entry. |
| provenance | string or null Identifier (e.g., URL or git hash) that uniquely ties this taxonomy back to an origin or place of record. |
| version required | string Semantic version of this taxonomy |
| isLatest | boolean Consider this the latest version of the taxonomy with this name? Defaults to True. |
{- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true
}{- "status": "success",
- "message": "string"
}{- "status": "success",
- "message": "string",
- "data": [
- {
- "groups": [
- null
], - "classifications": [
- null
], - "name": "string",
- "hierarchy": null,
- "provenance": "string",
- "version": "string",
- "isLatest": true,
- "id": 0
}
]
}Post new taxonomy
| name required | string Short string to make this taxonomy memorable to end users. |
| hierarchy required | object Nested JSON describing the taxonomy which should be validated against a schema before entry |
| group_ids | Array of integers List of group IDs corresponding to which groups should be able to view comment. Defaults to all of requesting user's groups. |
| version required | string Semantic version of this taxonomy name |
| provenance | string Identifier (e.g., URL or git hash) that uniquely ties this taxonomy back to an origin or place of record |
| isLatest | boolean Consider this version of the taxonomy with this name the latest? Defaults to True. |
{- "name": "string",
- "hierarchy": { },
- "group_ids": [
- 0
], - "version": "string",
- "provenance": "string",
- "isLatest": true
}{- "status": "success",
- "message": "string",
- "data": {
- "taxonomy_id": 0
}
}{- "status": "success",
- "message": "string",
- "data": {
- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true,
- "id": 0
}
}Update telescope
| telescope_id required | integer |
| instruments | Array of any |
| name required | string Unabbreviated facility name (e.g., Palomar 200-inch Hale Telescope). |
| nickname required | string Abbreviated facility name (e.g., P200). |
| lat | number or null Latitude in deg. |
| lon | number or null Longitude in deg. |
| elevation | number or null Elevation in meters. |
| diameter required | number Diameter in meters. |
| skycam_link | string or null Link to the telescope's sky camera. |
| weather_link | string or null Link to the preferred weather site |
| robotic | boolean Is this telescope robotic? |
| fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true
}{- "status": "success",
- "message": "string"
}Retrieve all telescopes
| name | string Filter by name (exact match) |
| latitudeMin | number Filter by latitude >= latitudeMin |
| latitudeMax | number Filter by latitude <= latitudeMax |
| longitudeMin | number Filter by longitude >= longitudeMin |
| longitudeMax | number Filter by longitude <= longitudeMax |
{- "status": "success",
- "message": "string",
- "data": [
- {
- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true,
- "id": 0
}
]
}Create telescopes
| instruments | Array of any |
| name required | string Unabbreviated facility name (e.g., Palomar 200-inch Hale Telescope). |
| nickname required | string Abbreviated facility name (e.g., P200). |
| lat | number or null Latitude in deg. |
| lon | number or null Longitude in deg. |
| elevation | number or null Elevation in meters. |
| diameter required | number Diameter in meters. |
| skycam_link | string or null Link to the telescope's sky camera. |
| weather_link | string or null Link to the preferred weather site |
| robotic | boolean Is this telescope robotic? |
| fixed_location | boolean Does this telescope have a fixed location (lon, lat, elev)? |
{- "instruments": [
- null
], - "name": "string",
- "nickname": "string",
- "lat": 0,
- "lon": 0,
- "elevation": 0,
- "diameter": 0,
- "skycam_link": "string",
- "weather_link": "string",
- "robotic": true,
- "fixed_location": true
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Retrieve weather info at the telescope site saved by user or telescope specified by telescope_id parameter
| telescope_id | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "weather": { },
- "weather_retrieved_at": "string",
- "weather_link": "string",
- "telescope_name": "string",
- "telescope_nickname": "string",
- "telescope_id": 0,
- "message": "string"
}
}{- "status": "success",
- "message": "string",
- "data": {
- "obj": null,
- "type": "new",
- "file_uri": "string",
- "public_url": "string",
- "origin": "string",
- "obj_id": "string",
- "is_grayscale": true,
- "id": 0
}
}Update thumbnail
| thumbnail_id required | integer |
| obj | any or null The Thumbnail's Obj. |
| type | string or null <= 6 characters Enum: "new" "ref" "sub" "sdss" "dr8" "ls" "ps1" "new_gz" "ref_gz" "sub_gz" Thumbnail type (e.g., ref, new, sub, ls, ps1, ...) |
| file_uri | string or null Path of the Thumbnail on the machine running SkyPortal. |
| public_url | string or null Publically accessible URL of the thumbnail. |
| origin | string or null Origin of the Thumbnail. |
| obj_id required | string ID of the thumbnail's obj. |
| is_grayscale | boolean Boolean indicating whether the thumbnail is (mostly) grayscale or not. |
{- "obj": null,
- "type": "new",
- "file_uri": "string",
- "public_url": "string",
- "origin": "string",
- "obj_id": "string",
- "is_grayscale": true
}{- "status": "success",
- "message": "string"
}Upload thumbnails
| obj_id | string ID of object associated with thumbnails. |
| data required | string <byte> base64-encoded PNG image file contents. Image size must be between 16px and 500px on a side. |
| ttype required | string Thumbnail type. Must be one of 'new', 'ref', 'sub', 'sdss', 'dr8', 'new_gz', 'ref_gz', 'sub_gz' |
{- "obj_id": "string",
- "data": "string",
- "ttype": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Get information on thumbnails that are or are not in the correct folder/path.
| types | Array of strings types of thumbnails to check The default is ['new', 'ref', 'sub'] which are all the thumbnail types stored locally. |
| requiredDepth | integer number of subdirectories that are desired for
thumbnails. For example if requiredDepth is 2,
then thumbnails will be stored in a folder like
/skyportal/static/thumbnails/ab/cd/ |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "inCorrectFolder": 0,
- "inWrongFolder": 0
}
}Update the file path and file_uri of the database rows of thumbnails that are not in the correct folder/path.
| types | Array of strings types of thumbnails to check The default is ['new', 'ref', 'sub'] which are all the thumbnail types stored locally. |
| requiredDepth | integer number of subdirectories that are desired for
thumbnails. For example if requiredDepth is 2,
then thumbnails will be stored in a folder like
/skyportal/static/thumbnails/ab/cd/ |
| numPerPage | integer Number of sources to check for updates. Defaults to 100. Max 500. |
| pageNumber | integer Page number for iterating through all sources. Defaults to 1 |
{- "status": "success",
- "message": "string",
- "data": {
- "totalMatches": 0,
- "inCorrectFolder": 0,
- "inWrongFolder": 0
}
}Delete an autoreporter from a TNSRobotGroup
| tnsrobot_id required | integer The ID of the TNSRobot |
| group_id required | integer The ID of the Group |
| user_id required | integer The ID of the User to remove as an autoreporter. If not provided, the user_id will be taken from the request body. |
| user_id | integer The ID of the User to remove as an autoreporter |
| user_ids | Array of integers The IDs of the Users to remove as autoreporters, overrides user_id |
{- "user_id": 0,
- "user_ids": [
- 0
]
}{- "status": "success",
- "message": "string"
}Add or edit a group for a TNS robot
| tnsrobot_id required | integer ID of the TNS robot |
| group_id required | integer ID of the group to edit |
| group_id | integer ID of the group to add |
| auto_report | boolean Whether to automatically report to this group |
| owner | boolean Whether this group is the owner of the TNS robot |
{- "group_id": 0,
- "auto_report": true,
- "owner": true
}{- "status": "success",
- "message": "string"
}{- "status": "success",
- "message": "string",
- "data": {
- "instruments": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "coauthors": [
- null
], - "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "acknowledgments": "string",
- "report_existing": true,
- "testing": true,
- "photometry_options": null,
- "id": 0,
- "submissions": [
- null
]
}
}Post or update a TNS robot
| instruments | Array of any |
| streams | Array of any |
| groups | Array of any |
| coauthors | Array of any |
| bot_name required | string Name of the TNS bot. |
| bot_id required | integer ID of the TNS bot. |
| source_group_id required | integer Source group ID of the TNS bot. |
| _altdata | string or null |
| acknowledgments | string Acknowledgments to use for this robot. |
| report_existing | boolean Whether to still report objects that are already in the TNS, but not reported with this object internal name (i.e., reported by another survey). |
| testing | boolean If true, robot will not report to TNS and only store the request's payload. |
| photometry_options | any or null Photometry options to use for this robot, to make some data optional or mandatory for manual and auto-reporting. |
| submissions | Array of any |
{- "instruments": [
- null
], - "streams": [
- null
], - "groups": [
- null
], - "coauthors": [
- null
], - "bot_name": "string",
- "bot_id": 0,
- "source_group_id": 0,
- "_altdata": "string",
- "acknowledgments": "string",
- "report_existing": true,
- "testing": true,
- "photometry_options": null,
- "submissions": [
- null
]
}{- "status": "success",
- "message": "string",
- "data": {
- "id": 0
}
}Grant new ACL(s) to a user
| user_id required | integer |
| aclIds required | Array of strings Array of ACL IDs (strings) to be granted to user |
{- "aclIds": [
- "string"
]
}{- "status": "success",
- "message": "string"
}Retrieve weather info at the telescope site saved by user or telescope specified by telescope_id parameter
| telescope_id | integer |
{- "status": "success",
- "message": "string",
- "data": {
- "weather": { },
- "weather_retrieved_at": "string",
- "weather_link": "string",
- "telescope_name": "string",
- "telescope_nickname": "string",
- "telescope_id": 0,
- "message": "string"
}
}Return the results of an analysis
| analysis_resource_type required | string What underlying data the analysis was performed on: must be "obj" (more to be added in the future) |
| token required | string The unique token for this analysis. |
| results | object Results data of this analysis |
{- "results": { }
}{- "status": "success",
- "message": "string"
}Retrieve a certain number of public pages, or all pages, for a given source from the most recent to the oldest
| source_id required | string The ID of the source for which to retrieve the public page |
| nb_results | integer The number of public pages to return |
{- "status": "success",
- "message": "string"
}Create a public page for a source, with given options, only if this page does not already exist
| source_id required | string The ID of the source from which to create a public page |
| options | object Options to manage data to display publicly |
{- "options": { }
}{- "status": "success",
- "message": "string"
}Display the public page for a given source and version
| source_id required | string The ID of the source for which to display the public page |
| version_hash required | string The hash of the source data used to identify the version |
{- "status": "error",
- "message": "string",
- "data": { }
}